Number.Round
Sintaxe
Number.Round(number as nullable number, optional digits as nullable number, optional roundingMode as nullable number) as nullable number
Sobre nós
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).
Exemplo 1
Arredondar 1,234 para o número inteiro mais próximo.
Utilização
Number.Round(1.234)
Output
1
Exemplo 2
Arredondar 1,56 para o número inteiro mais próximo.
Utilização
Number.Round(1.56)
Output
2
Exemplo 3
Arredondar o número 1,2345 para duas casas decimais.
Utilização
Number.Round(1.2345, 2)
Saída
1.23
Exemplo 4
Arredondar 1,2345 para três casas decimais (arredondar para cima).
Utilização
Number.Round(1.2345, 3, RoundingMode.Up)
Output
1.235
Exemplo 5
Arredondar 1,2345 para três dígitos decimais (arredondamento para baixo).
Utilização
Number.Round(1.2345, 3, RoundingMode.Down)
Output
1.234