Formate une valeur monétaire

# NumberFormatter::formatCurrency

# numfmt_format_currency

(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 function NumberFormatter::formatCurrency(float `$amount`, string `$currency`): string|false

Style procédural

function numfmt_format_currency(NumberFormatter `$formatter`, float `$amount`, string `$currency`): string|false

Formate une valeur monétaire, en fonction des règles du formateur.

### 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, par exemple le formatage de la monnaie avec un symbole monétaire court.

> Pour les utiliser pleinement, utiliser 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open