number_format

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

Descrição

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 .

Nota : 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( ) .