Compartir vía


Number.Round

Syntax

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

Acerca de

Devuelve el resultado del redondeo number al número más cercano. Si number es null, Number.Round devuelve null.

De forma predeterminada, number se redondea al entero más cercano y los empates se rompen redondeando al número par más cercano (usando RoundingMode.ToEven, también conocido como "redondeo del bancario").

Sin embargo, estos valores predeterminados se pueden invalidar a través de los siguientes parámetros opcionales.

  • digits: hace number que se redondee al número especificado de dígitos decimales.
  • roundingMode: invalida el comportamiento predeterminado de desempate cuando number está en el punto medio entre dos valores redondeados potenciales (consulte RoundingMode.Type para conocer los valores posibles).

Ejemplo 1

Redondeo 1.234 al entero más cercano.

Uso

Number.Round(1.234)

Salida

1

Ejemplo 2

Redondeo de 1,56 al entero más cercano.

Uso

Number.Round(1.56)

Salida

2

Ejemplo 3

Redondeo de 1,2345 a dos posiciones decimales.

Uso

Number.Round(1.2345, 2)

Salida

1.23

Ejemplo 4

Redondeo de 1,2345 a tres posiciones decimales (Redondeo hacia arriba).

Uso

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

Salida

1.235

Ejemplo 5

Redondeo de 1,2345 a tres posiciones decimales (Redondeo hacia abajo).

Uso

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

Salida

1.234