(PHP 4, PHP 5)
number_format — Formatear un número con los miles agrupados
$number
[, int $decimals = 0
] )$number
, int $decimals = 0
, string $dec_point = '.'
, string $thousands_sep = ','
)Esta función acepta uno, dos, o cuatro parámetros (no tres):
Si solo pasamos un parámetro,
number será formateado sin decimales,
pero con una coma (",") entre el grupo de miles.
Si pasamos dos parámetros, number será
formateado con tantos decimales como hayamos definido en decimals
colocando un punto (".") delante, y una coma (",") entre el grupo de miles.
Si damos valor a los cuatro parámetros, number
será formateado con tantos decimales como hayamos definido en decimals,
dec_point sustituirá al punto (".") como
seperador de los decimales y el separador por defecto de los miles, la coma (","),
será sustituida por thousands_sep.
numberEl número al que queremos dar formato.
decimalsEstablece el número de puntos decimales.
dec_pointEstablece el separador para los decimales.
thousands_sepEstablece el separador para los miles.
Versión formateada de number.
| Versión | Descripción |
|---|---|
| 5.4.0 |
Esta función ahora soporta múltiples bytes en
dec_point y
thousands_sep. Solamente el primer byte de cada
separador era utilizado en versiones anteriores.
|
Ejemplo #1 Ejemplo de number_format()
Para este ejemplo, la notación francesa suele utilizar dos decimales, una coma (',') como separador decimal y el espacio ('') como separador de miles. Veamos como se consigue esto mediante las siguientes líneas:
<?php
$number = 1234.56;
// notación inglesa (por defecto)
$english_format_number = number_format($number);
// 1,235
// notación inglesa con 3 decimales
$english_format_number2 = number_format($number, 3);
// 1,235.560
// notación francesa
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56
$number = 1234.5678;
// english notation without thousands seperator
$english_format_number = number_format($number, 2, '.', '');
// 1234.57
?>