PHP money_format() Fonction

❮ Référence de chaîne PHP

Exemple

Format international en_US :

<?php
$number = 1234.56;
setlocale(LC_MONETARY,"en_US");
echo money_format("Le prix est %i", $number);
?>

La sortie du code ci-dessus sera :

Le prix est USD 1,234.56

Définition et Utilisation

La fonction money_format() retourne une chaîne formatée comme une chaîne monétaire.

Remarque : Cette fonction a été dépréciée dans PHP 7.4.0 et supprimée dans PHP 8.0.0.

Cette fonction insère un nombre formaté là où se trouve un signe pourcentage (%) dans la chaîne principale.

Remarque : La fonction money_format() ne fonctionne pas sur les plateformes Windows.

Astuce : Cette fonction est souvent utilisée avec la fonction setlocale() .

Astuce : Pour voir tous les codes de langue disponibles, consultez notre Référence des codes de langue.

Syntaxe

money_format( string,number )

Valeurs des Paramètres

Paramètre Description
string Requis. Spécifie la chaîne à formater et comment formater les variables qu'elle contient.

Valeurs de format possibles :

Rembourrage et Drapeaux :

  • = f - Spécifie le caractère (f) à utiliser comme rembourrage (Exemple : %=t utilise "t" comme rembourrage). Par défaut, c'est un espace.
  • ^ - Supprime l'utilisation des caractères de regroupement.
  • + ou ( - Spécifie comment afficher les nombres positifs et négatifs. Si "+" est utilisé, le paramètre local pour + et - sera utilisé (généralement un signe devant les nombres négatifs, et rien devant les nombres positifs). Si "(" est utilisé, les nombres négatifs sont entourés de parenthèses. Par défaut, c'est "+".
  • ! - Arrête l'utilisation des symboles monétaires dans la chaîne de sortie.
  • - Si "-" est utilisé, tous les champs sont justifiés à gauche. Par défaut, c'est justifié à droite.

Largeur de champ :

  • x - Spécifie la largeur minimale du champ (x). Par défaut, c'est 0.
  • # x - Spécifie le nombre maximum (x) de chiffres attendus à gauche du point décimal. Cela est utilisé pour garder la sortie formatée alignée dans les mêmes colonnes. Si le nombre de chiffres est supérieur à x, cette spécification est ignorée.
  • . x - Spécifie le nombre maximum (x) de chiffres attendus à droite du point décimal. Si x est 0, le point décimal et les chiffres à sa droite ne seront pas affichés. Par défaut, c'est les paramètres locaux.

Caractères de conversion :

  • i - Le nombre est formaté au format monétaire international.
  • n - Le nombre est formaté au format monétaire national.
  • % - Retourne le caractère %.

Remarque : Si plusieurs valeurs de format sont utilisées, elles doivent être dans le même ordre que celui montré ci-dessus.

Remarque : Cette fonction est affectée par les paramètres locaux.

number Requis. Le nombre à insérer au signe %-dans la chaîne de format.

Détails Techniques

Valeur de Retour : Retourne la chaîne formatée. Les caractères avant et après la chaîne de formatage seront retournés inchangés. Un nombre non numérique provoque le retour de NULL et l'émission d'E_WARNING.
Version PHP : 4.3.0+

Plus d'Exemples

Exemple

Format international (Allemagne) avec 2 décimales :

<?php
$number = 1234.56;
setlocale(LC_MONETARY,"de_DE");
echo money_format("%.2n", $number);
?>

La sortie du code ci-dessus sera :

1 234,56 EUR

Exemple

Nombre négatif, format national américain avec () pour indiquer les nombres négatifs, 2 chiffres de précision à droite et "*" comme caractère de remplissage :

<?php
$number = -1234.5672;
echo money_format("%=*(#10.2n",$number);
?>

La sortie du code ci-dessus sera :

(******1234.57)

❮ Référence de chaîne PHP