number_format
(PHP 4, PHP 5)
number_format — Formatear un número con los millares agrupados
Descripción
$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 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.
Parámetros
-
number -
El número al que dar formato.
-
decimals -
Establece el número de puntos decimales.
-
dec_point -
Establece el separador para los decimales.
-
thousands_sep -
Establece el separador para los millares.
Valores devueltos
Una versión formateada de number.
Historial de cambios
| 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.
|
Ejemplos
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
?>
Ver también
- money_format() - Da formato a un número como un string de moneda
- sprintf() - Devuelve un string formateado
- printf() - Imprimir una cadena con formato
- sscanf() - Interpreta un string de entrada de acuerdo con un formato