array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'numberformatter.format.php', 1 => 'NumberFormatter::format', 2 => 'Formata um número', ), 'up' => array ( 0 => 'class.numberformatter.php', 1 => 'NumberFormatter', ), 'prev' => array ( 0 => 'numberformatter.create.php', 1 => 'NumberFormatter::create', ), 'next' => array ( 0 => 'numberformatter.formatcurrency.php', 1 => 'NumberFormatter::formatCurrency', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/intl/numberformatter/format.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 NumberFormatter::format(int|float $num, int $type = NumberFormatter::TYPE_DEFAULT): string|false

Estilo procedural

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