Number.Round
Number.Round(number as nullable number, optional digits as nullable number, optional roundingMode as nullable number) as nullable number
Devolve o resultado do arredondamento number
para o número mais próximo. Se number
é nulo, Number.Round retorna nulo.
Por padrão, number
é arredondado para o número inteiro mais próximo, e os desempates são resolvidos arredondando para o número par mais próximo (usando RoundingMode.ToEven, também conhecido como "arredondamento do 'banqueiro'").
No entanto, esses padrões podem ser substituídos através dos seguintes parâmetros opcionais.
-
digits
: Faz com quenumber
sejam arredondados 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 (consulte RoundingMode.Type para valores possíveis).
Arredondar 1,234 para o número inteiro mais próximo.
Utilização
Number.Round(1.234)
Output
1
Arredondar 1,56 para o número inteiro mais próximo.
Utilização
Number.Round(1.56)
Output
2
Arredondar o número 1,2345 para duas casas decimais.
Utilização
Number.Round(1.2345, 2)
Saída
1.23
Arredondar 1,2345 para três casas decimais (arredondar para cima).
Utilização
Number.Round(1.2345, 3, RoundingMode.Up)
Output
1.235
Arredondar 1,2345 para três dígitos decimais (arredondamento para baixo).
Utilização
Number.Round(1.2345, 3, RoundingMode.Down)
Output
1.234