Ler em inglês

Compartilhar via


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 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 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 (veja RoundingMode.Type para obter os valores possíveis).

Exemplo 1

Arredonde 1,234 para o próximo número inteiro.

Usage

Number.Round(1.234)

Saída

1

Exemplo 2

Arredonde 1,56 para o próximo número inteiro.

Usage

Number.Round(1.56)

Saída

2

Exemplo 3

Arredonde 1,2345 para duas casas decimais.

Usage

Number.Round(1.2345, 2)

Saída

1.23

Exemplo 4

Arredonde 1,2345 para três casas decimais (arredondamento para cima).

Usage

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

Saída

1.235

Exemplo 5

Arredonde 1,2345 para três casas decimais (arredondamento para baixo).

Usage

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

Saída

1.234