Manual do PHP
Anterior |  | Próxima

# number_format

(PHP 3, PHP 4 , PHP 5)

number_format -- Formata um número com os milhares agrupados

## Descrição

string number_format ( float number [, int decimals] )
string number_format ( float 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 ?>`

Veja também: sprintf(), printf() e sscanf().

Anterior | Principal | Próxima
nl2br | Acima | ord