Formata um número

# NumberFormatter::format

# numfmt_format

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

NumberFormatter::format -- numfmt_format — Formata um número

### Descrição

Estilo orientado a objetos

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

Estilo procedural

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

Formata um valor numérico de acordo com as regras de formatação.

### Parâmetros

`formatter`

  Objeto NumberFormatter.

`num`

  O valor a formatar. Pode ser int ou float, outros tipos serão convertidos para valores numéricos.

`type`

  O tipo de formatação a ser usado. Observe que `NumberFormatter::TYPE_CURRENCY` não é suportado; use NumberFormatter::formatCurrency() em seu lugar.

### Valor Retornado

Retorna a string contendo o valor formatado, ou `false` em caso de erro.

### Exemplos

Exemplo #1 Exemplo de numfmt_format()

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

Exemplo #2 Exemplo OO

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

O exemplo acima produzirá:

    string(13) "1.234.567,891"

### Notas

> Nota:

> Formatos possíveis por este método não usam todas as possibilidades da biblioteca ICU subjacente, como por exemplo usar o símbolo da moeda em sua forma curta ou abreviada.

> Para usar todas as possibilidades, use a função msgfmt_format_message().

### Veja Também

- numfmt_get_error_code() - Obtém o último código de erro do formatador
- numfmt_format_currency() - Formata um valor de moeda
- numfmt_parse() - Interpreta um número
- msgfmt_format_message() - Formata uma mensagem rapidamente

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