Fonction number_format

La fonction number_format permet de formater un nombre. Elle est principalement utilisée pour séparer les milliers par des espaces, par exemple, transformer 1234567 en 1 234 567.

De plus, la fonction permet de régler le nombre de décimales. Ce nombre est défini par le deuxième paramètre optionnel.

Par exemple, on peut transformer la fraction 12345.6789 en 12 345.68 - la fonction ajoutera des espaces entre les milliers et arrondira la fraction à deux décimales.

Le troisième paramètre optionnel définit le séparateur décimal (par défaut un point, mais on peut le changer). Impérativement, avec le troisième paramètre, doit figurer le quatrième - il définit le séparateur de milliers (par défaut une virgule, mais on peut le changer, par exemple, en un espace). C'est-à-dire que par défaut la fonction sépare les milliers par des virgules : transforme 1234567 en 1,234,567.

Syntaxe

number_format(float $num, int $decimals = 0, ?string $decimal_separator = ".", ?string $thousands_separator = ","): string

number_format(nombre, nombre_de_décimales);

number_format(nombre, nombre_de_décimales, séparateur_décimal, séparateur_des_milliers);

Exemple

Séparons les milliers par une virgule :

<?php
	echo number_format(1234567);
?>

Résultat de l'exécution du code :

'1,234,567'

Exemple

Séparons les milliers par une virgule, et arrondissons la partie décimale à deux décimales :

<?php
	echo number_format(1234.567, 2);
?>

Résultat de l'exécution du code :

'1,234.57'

Exemple

Séparons les milliers par un espace, arrondissons la partie décimale à deux décimales, et utilisons une barre oblique comme séparateur décimal :

<?php
	echo number_format(1234.567, 2, '/', ' ');
?>

Résultat de l'exécution du code :

1 234/57

Exemple

Séparons les milliers par un espace, arrondissons la partie décimale à deux décimales, et utilisons un point comme séparateur décimal :

<?php
	echo number_format(1234.567, 2, '.', ' ');
?>

Résultat de l'exécution du code :

1 234.57

Voir aussi

la fonction printf,
qui formate une chaîne de caractères