Formata um número com milhares agrupados

Descrição

number_format(
    float $num,
    int $decimals = 0,
    ?string $decimal_separator = ".",
    ?string $thousands_separator = ","
): string

Formata um número com milhares agrupados e opcionalmente dígitos decimais usando a regra de arredondamento de meia unidade para cima.

Parâmetros

num: O número a ser formatado.
decimals: Define o número de dígitos decimais. Se for igual a 0, o separador de decimais definido por decimal_separator é omitido do valor de retorno.
decimal_separator: Define a string separadora de decimais.
thousands_separator: Define a string separadora de milhares.

Valor Retornado

Uma versão formatada de num.

Registro de Alterações

Versão	Descrição
8.0.0	Antes desta versão, number_format() aceitava um, dois ou quatro parâmetros (mas não três).
7.2.0	number_format() foi modificado para não ser capaz de retornar `-0`, anteriormente `-0` poderia ser retornado para casos onde `num` fosse `-0.01`.

Exemplos

Example #1 Exemplo de number_format()

Por exemplo, a notação francesa normalmente usa duas casas decimais, vírgula (',') como separador de decimais e espaço (' ') como separador de milhares. O exemplo a seguir demonstra várias formas de formatar um número:

<?php

$number = 1234.56;

// notação inglesa (padrão)
$english_format_number = number_format($number);
// 1,235

// notação francesa
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56

$number = 1234.5678;

// notação inglesa sem separador de milhares
$english_format_number = number_format($number, 2, '.', '');
// 1234.57

?>

Veja Também

money_format() - Formata um número como uma string de moeda
sprintf() - Retona uma string formatada
printf() - Envia uma string formatada para a saída
sscanf() - Interpreta a entrada de uma string de acordo com um formato