Formatear números con PHP

Cuando mostramos un número en una página web podemos querer que tenga un formato específico. Por ejemplo, que tenga sólo dos decimales, o que utilice comas -o puntos- para separar decimales, así como las unidades de millar. Típicos formatos de número podrían ser:

1.000.505,56
5003.60
5,000.00
…

Presentar los números con uno u otro formato es sencillo, ya que en PHP existe una función específica para dar formato a los números, que dependiendo de los parámetros recibidos los formateará de una u otra manera. En este artículo vamos a conocer dicha función, así como sus posibilidades de configuración y ver varios ejemplos.

Función number_format()

El formateo de números lo llevaremos a cabo con la función de PHP number_format(). Esta función recibe uno, dos o cuatro parámetros. Es decir, tenemos estas restricciones:

• Hay un único parámetro obligado (el número que queremos formatear).
• El segundo parámetro es opcional, tal como el tercero y el cuarto
• Pero si especificamos el tercer parámetro, estamos obligados a especificar también el cuarto.

Veamos con detalle los parámetros de la función de formateo de números de PHP, con diversos ejemplos.

Parámetro 1, el número:
El primer parámetro es el número a formatear. Tal como dijimos, aunque resulta obvio, es un parámetro siempre necesario.

$numero = 15200.67;
number_format($numero);
//devuelve 15,201

En este caso, el formateo del número nos dará el número sin decimales y con una coma como separador de miles. Este formato es el que se utiliza en inglés (las personas de habla inglesa separan con comas los millares al escribir los números), que seguramente no nos sirva a los desarrolladores que trabajamos en español.

Cabe fijarse que la función number_format() ha realizado también un redondeo de los decimales que no está mostrando. Este redondeo lo vamos a ver bien en este ejemplo:

$numero = 999999999.99;
number_format($numero);
//devuelve 1,000,000,000

Parámetro 2, los decimales:
Con el segundo parámetro, que es opcional, indicamos el número de decimales que queremos que aparezcan en el número formateado.

$numero = 15200.67;
number_format($numero,2);
//devuelve 15,201.67

Como vemos, en este caso se han incorporado dos decimales al formato del número. Utiliza comas para separar los miles y un punto para separar las unidades de millar. Como vemos, sigue utilizando la notación inglesa para formatear números.

Otro ejemplo, en el que podemos apreciar que siempre se hace un redondeo del número, si los decimales a mostrar son menos que los que tiene el número original.

$numero = 1885200.89;
number_format($numero,1);
//devuelve 1,885,200.9

Parámetros 3 y 4, separadores de decimales y de unidades de millar
Los últimos parámetros, que debemos utilizar siempre juntos, sirven para especificar los separadores que queremos utilizar para los decimales y las unidades de millar. Si queremos formatear los números con la notación española tendríamos que utilizar forzosamente estos parámetros.

Por ejemplo, así haríamos para formatear los números en español:

• Separar los decimales con coma
• Separar las unidades de millar con un punto.

$numero = 1002002.365;
number_format($numero, 2, ",", ".");
//devuelve 1.002.002,37

Si, por ejemplo, no separar los millares, simplemente pasamos como separador de unidades de millar (cuarto parámetro) la cadena vacía:

$numero = 9540.2;
number_format($numero, 2, ",", "");
//devuelve 9540,20