Number.Round
Number.Round(number as nullable number, optional digits as nullable number, optional roundingMode as nullable number) as nullable number
Retorna o resultado do arredondamento de number
para o número mais próximo. Se number
for nulo, Number.Round retornará um valor nulo.
Por padrão, number
é arredondado para o número inteiro mais próximo, e os empates são desfeitos pelo arredondamento para o número par mais próximo (usando RoundingMode.ToEven, também conhecido como "arredondamento bancário").
No entanto, esses padrões podem ser substituídos por meio dos parâmetros opcionais a seguir.
digits
: faz com quenumber
seja arredondado para o número especificado de dígitos decimais.roundingMode
: substitui o comportamento de desempate padrão quandonumber
está no ponto médio entre dois valores arredondados potenciais (veja RoundingMode.Type para obter os valores possíveis).
Arredonde 1,234 para o próximo número inteiro.
Usage
Number.Round(1.234)
Saída
1
Arredonde 1,56 para o próximo número inteiro.
Usage
Number.Round(1.56)
Saída
2
Arredonde 1,2345 para duas casas decimais.
Usage
Number.Round(1.2345, 2)
Saída
1.23
Arredonde 1,2345 para três casas decimais (arredondamento para cima).
Usage
Number.Round(1.2345, 3, RoundingMode.Up)
Saída
1.235
Arredonde 1,2345 para três casas decimais (arredondamento para baixo).
Usage
Number.Round(1.2345, 3, RoundingMode.Down)
Saída
1.234