Função number_format() do PHP

Exemplo

Formatar número:

<?php
echo number_format("5000000")."<br>";
echo number_format("5000000",2)."<br>";
echo number_format("5000000",2,",",".");
?>

Executar Exemplo

Definição e Uso

A função number_format() formata números através de grouping de milhares.

Comentário:A função number_format() suporta um, dois ou quatro parâmetros (não três).

Sintaxe

number_format(number,decimals,decimalpoint,separator)
Parâmetros Descrição
number

Obrigatório. O número a ser formatado.

Se nenhum outro parâmetro foi configurado, o número será formatado sem ponto decimal e com vírgula (,) como separador de milhares.

decimals Opcional. Especifica quantas casas decimais. Se este parâmetro foi configurado, usamos o ponto (.) como ponto decimal para formatar o número.
decimalpoint Opcional. Especifica a string usada como ponto decimal.
separator

Opcional. Especifica a string usada como separador de milhares. Usamos apenas o primeiro caractere deste parâmetro. Por exemplo, "xxx" apenas sai "x".

Comentário:Se este parâmetro foi configurado, todos os outros parâmetros são necessários.

Detalhes Técnicos

Retorno: Retorna o número formatado.
Versão PHP: 4+
Registro de Atualizações:

A partir do PHP 5.4, a função está no parâmetro decimalpoint e separator Suporta múltiplos bytes.

Em versões mais antigas, apenas o primeiro byte de cada delimitador era usado.

Mais Exemplos

Exemplo 1

Você deseja retornar um preço: um parâmetro arredondará o número (formatará sem casas decimais), dois parâmetros fornecerão o resultado desejado:

<?php
$num = 4999.9;
$formattedNum = number_format($num)."<br>";
echo $formattedNum;
$formattedNum = number_format($num, 2);
echo $formattedNum;
?>

Executar Exemplo