Função number_format

A função number_format permite formatar um número. É usada principalmente para separar os milhares com espaços, por exemplo, transformar 1234567 em 1 234 567.

Além disso, a função permite regular a quantidade de casas decimais. Esta quantidade é definida pelo segundo parâmetro opcional.

Por exemplo, pode-se transformar a fração 12345.6789 na fração 12 345.68 - a função adicionará espaços entre os milhares e arredondará a fração para duas casas decimais.

O terceiro parâmetro opcional define o separador decimal (por padrão é o ponto, mas pode ser alterado). Obrigatoriamente, junto com o terceiro parâmetro deve vir o quarto - ele define o separador de milhares (por padrão é a vírgula, mas pode ser alterado, por exemplo, para espaço). Ou seja, por padrão a função separa os milhares com vírgulas: transforma 1234567 em 1,234,567.

Sintaxe

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

number_format(número, quantidade de casas decimais);

number_format(número, quantidade de casas decimais, separador decimal, separador de milhares);

Exemplo

Vamos separar os milhares com vírgula:

<?php
	echo number_format(1234567);
?>

Resultado da execução do código:

'1,234,567'

Exemplo

Vamos separar os milhares com vírgula, e arredondar a parte decimal para duas casas:

<?php
	echo number_format(1234.567, 2);
?>

Resultado da execução do código:

'1,234.57'

Exemplo

Vamos separar os milhares com espaço, arredondar a parte decimal para duas casas, e usar a barra como separador decimal:

<?php
	echo number_format(1234.567, 2, '/', ' ');
?>

Resultado da execução do código:

1 234/57

Exemplo

Vamos separar os milhares com espaço, arredondar a parte decimal para duas casas, e usar o ponto como separador decimal:

<?php
	echo number_format(1234.567, 2, '.', ' ');
?>

Resultado da execução do código:

1 234.57

Veja também

a função printf,
que formata uma string