number_format

(PHP 3, PHP 4 )

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