(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
NumberFormatter::formatCurrency -- numfmt_format_currency — Formate une valeur monétaire
Description
Style orienté objet
public
NumberFormatter::formatCurrency(float
$amount
, string
$currency
): string|false
numfmt_format_currency(NumberFormatter
$formatter
, float
$amount
, string
$currency
): string|false
Liste de paramètres
-
formatter
-
L'objet NumberFormatter.
-
amount
-
La valeur numérique.
-
currency
-
Le code à trois lettres ISO 4217 de la devise à utiliser.
Valeurs de retour
La chaîne représentant la valeur monétaire formatée, ou false
si une erreur survient.
Exemples
Exemple #1 Exemple avec numfmt_format_currency(), Style procédural
<?php
$fmt = numfmt_create( 'de_DE', NumberFormatter::CURRENCY );
echo numfmt_format_currency($fmt, 1234567.891234567890000, "EUR")."\n";
echo numfmt_format_currency($fmt, 1234567.891234567890000, "RUR")."\n";
$fmt = numfmt_create( 'ru_RU', NumberFormatter::CURRENCY );
echo numfmt_format_currency($fmt, 1234567.891234567890000, "EUR")."\n";
echo numfmt_format_currency($fmt, 1234567.891234567890000, "RUR")."\n";
?>
Exemple #2 Exemple avec numfmt_format_currency(), style POO
<?php
$fmt = new NumberFormatter( 'de_DE', NumberFormatter::CURRENCY );
echo $fmt->formatCurrency(1234567.891234567890000, "EUR")."\n";
echo $fmt->formatCurrency(1234567.891234567890000, "RUR")."\n";
$fmt = new NumberFormatter( 'ru_RU', NumberFormatter::CURRENCY );
echo $fmt->formatCurrency(1234567.891234567890000, "EUR")."\n";
echo $fmt->formatCurrency(1234567.891234567890000, "RUR")."\n";
?>
L'exemple ci-dessus va afficher :
1.234.567,89 €
1.234.567,89 RUR
1 234 567,89€
1 234 567,89р.
Notes
Note:
Les formats réalisables par cette méthode de formatage ne peuvent pas utiliser pleinement les possibilités de
la bibliothèque ICU sous-jacente, comme par exemple le formatage de la monnaie avec un symbole monétaire court.
Pour les utiliser pleinement, utilisez msgfmt_format_message().
Voir aussi
- numfmt_get_error_code() - Lit le dernier code d'erreur du formateur
- numfmt_format() - Formate un nombre
- numfmt_parse_currency() - Analyse un nombre monétaire
- msgfmt_format_message() - Formate rapidement un message