Saltar para o conteúdo principal

Number.Round

Devolve o número arredondado. É possível especificar o número de dígitos e o modo de arredondamento.

Syntax​

Number.Round(
    number as number,
    optional digits as number,
    optional roundingMode as RoundingMode.Type
) as number

Remarks​

Devolve o resultado do arredondamento number para o número mais próximo. Se number for nulo, Number.Round devolve null.

Por predefinição, number é arredondado para o número inteiro mais próximo e o critério de decisão efetua o arredondamento para o número par mais próximo (utilizando RoundingMode.ToEven, também conhecido como "arredondamento bancário").

No entanto, estas predefinições podem ser substituídas através dos seguintes parâmetros opcionais.

  • digits: Faz com que number seja arredondado para o número de dígitos decimais especificado.
  • roundingMode: Substitui o comportamento do critério de decisão predefinido quando number estiver no ponto intermédio entre dois valores potencialmente arredondados (consulte RoundingMode.Type para saber possíveis valores).

Examples​

Example #1​

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

Number.Round(1.234)

Result:

1

Example #2​

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

Number.Round(1.56)

Result:

2

Example #3​

Arredondar 1,2345 para duas casas decimais.

Number.Round(1.2345, 2)

Result:

1.23

Example #4​

Arredondar 1,2345 para três casas decimais (por excesso).

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

Result:

1.235

Example #5​

Arredondar 1,2345 para três casas decimais (por defeito).

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

Result:

1.234

Category​

Number.Rounding