Formate un nombre

# NumberFormatter::format

# numfmt_format

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

NumberFormatter::format -- numfmt_format — Formate un nombre

### Description

Style orienté objet

public function NumberFormatter::format(int|float `$num`, int `$type` = `NumberFormatter::TYPE_DEFAULT`): string|false

Style procédural

function numfmt_format(NumberFormatter `$formatter`, int|float `$num`, int `$type` = `NumberFormatter::TYPE_DEFAULT`): string|false

Formate une valeur numérique, selon les règles du formateur.

### Liste de paramètres

`formatter`

  L'objet NumberFormatter.

`num`

  La valeur à formater. Ce peut être un int ou un float. Les autres valeurs seront converties en valeur numérique avant le formatage.

`type`

  Le type de format. Il est à noter que `NumberFormatter::TYPE_CURRENCY` n'est pas pris en charge ; utiliser NumberFormatter::formatCurrency() à la place.

### Valeurs de retour

Retourne la chaîne contenant la valeur formatée, ou `false` en cas d'erreur.

### Exemples

Exemple #1 Exemple avec numfmt_format(), Style procédural

    <?php
    $fmt = numfmt_create( 'de_DE', NumberFormatter::DECIMAL );
    $data = numfmt_format($fmt, 1234567.891234567890000);
    var_dump($data);
    ?>

Exemple #2 Exemple avec numfmt_format(), style POO

    <?php
    $fmt = new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
    $data = $fmt->format(1234567.891234567890000);
    var_dump($data);
    ?>

L'exemple ci-dessus va afficher :

    string(13) "1.234.567,891"

### 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_currency() - Formate une valeur monétaire
- numfmt_parse() - Analyse un nombre
- msgfmt_format_message() - Formate rapidement un message

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