Forum und email

number_format

(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.

Example#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($number2','' ');
// 1 234,56

$number 1234.5678;

// Notação Inglesa com separador de milhar
$english_format_number number_format($number2'.''');
// 1234.57

?>

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