Formate un nombre pour l'affichage

Description

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

Formate un nombre avec les milliers groupés et optionnellement des chiffres décimaux.

Liste de paramètres

num: Le nombre à formater.
decimals: Définit le nombre de chiffres décimales. Si 0, le decimal_separator est omis de la valeur de retour.
decimal_separator: Définit le séparateur pour le point décimal.
thousands_separator: Définit le séparateur des milliers.

Valeurs de retour

Une version formatée du nombre num.

Historique

Version	Description
8.0.0	Antérieur à cette version, number_format() accepte un, deux, ou quatre paramètres (mais pas trois).
7.2.0	number_format() a été modifié pour ne plus permettre de retourner `-0`, précédemment `-0` pouvait être retourné pour des cas où `num` valait `-0.01`.

Exemples

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

?>

Voir aussi

money_format() - Met un nombre au format monétaire
sprintf() - Retourne une chaîne formatée
printf() - Affiche une chaîne de caractères formatée
sscanf() - Analyse une chaîne à l'aide d'un format