(PHP 4, PHP 5, PHP 7)
number_format — Formate un nombre pour l'affichage
$number
[, int $decimals = 0
] ) : string$number
, int $decimals = 0
, string $dec_point = "."
, string $thousands_sep = ","
) : stringCette fonction accepte un, deux, ou quatre paramètres (et pas trois) :
Si seul le paramètre number est donné,
il sera formaté sans partie décimale, mais avec une
virgule entre chaque millier.
Si les deux paramètres number et
decimals sont fournis, number sera
formaté avec decimals décimales,
un point (".") comme séparateur décimal et une virgule entre chaque
millier.
Avec quatre paramètres, number sera
formaté avec decimals décimales,
dec_point comme séparateur décimal, et
thousands_sep comme séparateur de milliers.
numberLe nombre à formater.
decimalsDéfinit le nombre de décimales.
dec_pointDéfinit le séparateur pour le point décimal.
thousands_sepDéfinit le séparateur des milliers.
Une version formatée du nombre number.
| Version | Description |
|---|---|
| 7.2.0 |
number_format() a été modifié pour ne plus permettre de
retourner -0, précedement -0 pouvait
être retourné pour des cas où number valait -0.01.
|
| 5.4.0 |
Cette fonction supporte maintenant des paramètres
dec_point et
thousands_sep comportant plusieurs caractères.
Seul le premier caractère était utilisé avant.
|
Exemple #1 Exemple avec number_format()
En notation française, on utilise généralement deux chiffres après la virgule, une virgule comme séparateur décimal, et un espace comme séparateur de milliers. L'exemple suivant montre comment formater un nombre de différentes façons :
<?php
$number = 1234.56;
// Notation anglaise (par défaut)
$english_format_number = number_format($number);
// 1,235
// Notation française
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56
$number = 1234.5678;
// Notation anglaise sans séparateur de milliers
$english_format_number = number_format($number, 2, '.', '');
// 1234.57
?>