(PHP 4, PHP 5, PHP 7)
number_format — Formata um número com os milhares agrupados
$number
[, int $decimals
] )$number
, int $decimals
, string $dec_point
, string $thousands_sep
)
number_format() retorna uma versão formatada de
number. Esta função aceita um,
dois ou quatro parâmetros (não três):
Se apenas um parâmetro é dado,
number será formatado sem decimais,
mas com uma virgula (",") entre cada grupo de milhar.
Se dois parâmetros são dados, number será formatado com
o número de casas decimais especificadas em decimals com um ponto
(".") na frente, e uma vírgula (",") entre cada grupo de milhar.
Se todos os quatro parâmetros forem dados, number
será formatado com o número de casas decimais em decimals,
dec_point ao invés do ponto (".")
antes das casas decimais e thousands_sep ao invés de uma vírgula
(",") entre os grupos de milhares.
Somente o primeiro caractere de thousands_sep
é usado. Por exemplo, se você usar foo como o parâmetro
thousands_sep no número
1000, number_format() irá retornar 1f000.
Exemplo #1 Exemplo number_format()
Por exemplo, a notação Francesa usa duas casas decimais, vírgula (',') como separador decimal, e espaço (' ') como separador de milhar. Isto é feito com a linha :
<?php
$number = 1234.56;
// Notação Inglesa (padrão)
$english_format_number = number_format($number);
// 1,234
// Notação Francesa
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56
$number = 1234.5678;
// Notação Inglesa com separador de milhar
$english_format_number = number_format($number, 2, '.', '');
// 1234.57
?>