(PHP 4, PHP 5, PHP 7)
number_format — Formatear un número con los millares agrupados
$number
[, int $decimals = 0
] ) : string$number
, int $decimals = 0
, string $dec_point = "."
, string $thousands_sep = ","
) : stringEsta función acepta uno, dos, o cuatro parámetros (no tres):
Si solo se proporciona un parámetro,
number será formateado sin decimales,
pero con una coma (",") entre cada grupo de millares.
Si se proporcionan dos parámetros, number será
formateado con tantos decimales como se hayan definido en decimals
colocando un punto (".") delante, y una coma (",") entre cada grupo de
millares.
Si se proporcionan 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 millares, la coma (","),
será sustituida por thousands_sep.
numberEl número al que dar formato.
decimalsEstablece el número de puntos decimales.
dec_pointEstablece el separador para los decimales.
thousands_sepEstablece el separador para los millares.
Una versión formateada de number.
| Versión | Descripción |
|---|---|
| 5.4.0 |
Esta función ahora admite múltiples bytes en
dec_point y
thousands_sep. En versiones anteriors solamente
se utilizaba el primer byte de cada separador.
|
Ejemplo #1 Ejemplo de number_format()
Por ejemplo, la notación francesa suele utilizar dos decimales, una coma (',') como separador decimal y el espacio (' ') como separador de millares. Esto consigue esto mediante las siguientes líneas:
<?php
$número = 1234.56;
// notación inglesa (por defecto)
$número_formato_inglés = number_format($número);
// 1,235
// notación francesa
$nombre_format_francais = number_format($número, 2, ',', ' ');
// 1 234,56
$número = 1234.5678;
// notación inglesa sin separador de millares
$english_format_number = number_format($número, 2, '.', '');
// 1234.57
?>