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 que number seja arredondado para o número especificado de dígitos decimais.
• roundingMode: Substitui o comportamento de desempate padrão quando number 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)

Output

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