Number.Round

Sintaxe

Number.Round(
    number as nullable number,
    optional digits as nullable number,
    optional roundingMode as nullable number
) as nullable number

Sobre

Retorna o resultado do arredondamento number para o número mais próximo. Se number for nulo, Number.Round retornará nulo.

Por padrão, number é arredondado para o inteiro mais próximo e os laços são quebrados 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 por meio dos seguintes parâmetros opcionais.

• digits: faz number com que seja arredondado para o número especificado de dígitos decimais.
• roundingMode: substitui o comportamento padrão de quebra de empate quando number está no ponto médio entre dois valores arredondados potenciais (consulte RoundingMode.Type os valores possíveis).

Exemplo 1

Round 1.234 para o inteiro mais próximo.

Usage

Number.Round(1.234)

Saída

1

Exemplo 2

Arredondar 1,56 para o inteiro mais próximo.

Usage

Number.Round(1.56)

Saída

2

Exemplo 3

Rodada 1.2345 para duas casas decimais.

Usage

Number.Round(1.2345, 2)

Saída

1.23

Exemplo 4

Rodada 1,2345 para três casas decimais (arredondando para cima).

Usage

Number.Round(1.2345, 3, RoundingMode.Up)

Saída

1.235

Exemplo 5

Rodada 1,2345 para três casas decimais (arredondando para baixo).

Usage

Number.Round(1.2345, 3, RoundingMode.Down)

Saída

1.234