number_format

number_format(float $num, [int $decimals], [string $decimal_separator], [string $thousands_separator]): string
```php

Formatea un número con los miles agrupados y opcionalmente con cifras decimales utilizando la regla de redondeo al más cercano.

## Parámetros

`num`  
El número a formatear.

`decimals`  
Define el número de cifras decimales. Si es `0`, el `decimal_separator` es omitido del valor de retorno. A partir de PHP 8.3.0, cuando el valor es negativo, `num` es redondeado a `decimals` cifras significativas antes del punto decimal. Antes de PHP 8.3.0, los valores negativos eran ignorados y tratados de la misma manera que `0`.

`decimal_separator`  
Define el separador para el punto decimal.

`thousands_separator`  
Define el separador de miles.

## Valores devueltos

Una versión formateada del número `num`.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.3.0 | Se añadió el manejo de valores negativos para `decimals`. |
| 8.0.0 | Antes de esta versión, `number_format` aceptaba uno, dos o cuatro argumentos (pero no tres). |
| 7.2.0 | `number_format` fue modificado para no permitir devolver `-0`, anteriormente `-0` podía ser devuelto para casos donde `num` valía `-0.01`. |

Un valor negativo para `decimals`

A partir de PHP 8.3.0, un valor negativo para `decimals` es utilizado para redondear el número de cifras significativas antes del punto decimal.

El ejemplo anterior mostrará:

    string(5) "1 230"
    string(5) "1 200"
    string(5) "1 000"

## Ejemplos

Ejemplo con `number_format`

En notación francesa, se utilizan generalmente dos cifras después de la coma, una coma como separador decimal y un espacio como separador de miles. El siguiente ejemplo muestra cómo formatear un número de diferentes maneras: