Documentación offline PHP master

bcround

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

bcround

Redondea un número de precisión arbitraria

Descripción#

bcround(string $num, [int $precision], [RoundingMode $mode]): string
```php

Devuelve el valor redondeado de `num` a la precisión especificada `precision` (número de dígitos después del punto decimal). `precision` puede ser también negativo o nulo (por omisión).

## Parámetros

## Valores devueltos

Devuelve una cadena numérica representando `num` redondeado a la precisión dada.

## Errores/Excepciones

Esta función lanza una ValueError en los siguientes casos: `num` no es una cadena numérica BCMath bien formada., Un `mode` inválido es especificado.

## Ejemplos

Ejemplos de `bcround`
El ejemplo anterior mostrará:

string(1) "3" string(1) "4" string(1) "4" string(1) "4" string(4) "5.05" string(4) "5.06" string(3) "300" string(1) "0" string(3) "700" string(4) "1000"

Ejemplo de la utilización de `bcround` con diferentes valores de `precision`
El ejemplo anterior mostrará:

string(7) "123.450" string(6) "123.45" string(5) "123.5" string(3) "123" string(3) "120" string(3) "100" string(1) "0"

Ejemplo de la utilización de `bcround` con diferentes valores de `mode`
El ejemplo anterior mostrará:

Modos de redondeo con 9.5 string(2) "10" string(1) "9" string(2) "10" string(1) "9" string(1) "9" string(2) "10" string(1) "9" string(2) "10"

Modos de redondeo con 8.5 string(1) "9" string(1) "8" string(1) "8" string(1) "9" string(1) "8" string(1) "9" string(1) "8" string(1) "9"

Ejemplo de la utilización de `bcround` con diferentes valores de `mode` al especificar `precision`
El ejemplo anterior mostrará:

Utilización de RoundingMode::HalfAwayFromZero con una precisión decimal de 1 string(3) "1.6" string(4) "-1.6"

Utilización de RoundingMode::HalfTowardsZero con una precisión decimal de 1 string(3) "1.5" string(4) "-1.5"

Utilización de RoundingMode::HalfEven con una precisión decimal de 1 string(3) "1.6" string(4) "-1.6"

Utilización de RoundingMode::HalfOdd con una precisión decimal de 1 string(3) "1.5" string(4) "-1.5"

Utilización de RoundingMode::TowardsZero con una precisión decimal de 1 string(3) "1.5" string(4) "-1.5"

Utilización de RoundingMode::AwayFromZero con una precisión decimal de 1 string(3) "1.6" string(4) "-1.6"

Utilización de RoundingMode::NegativeInfinity con una precisión decimal de 1 string(3) "1.5" string(4) "-1.6"

Utilización de RoundingMode::PositiveInfinity con una precisión decimal de 1 string(3) "1.6" string(4) "-1.5"

```php

Véase también#

bcceil

bcfloor

BcMath\Number::round