(PHP 4, PHP 5, PHP 7, PHP 8)
number_format — Formata um número com milhares agrupados
$num
,$decimals
= 0,$decimal_separator
= ".",$thousands_separator
= ","Formata um número com milhares agrupados e opcionalmente dígitos decimais usando a regra de arredondamento de meia unidade para cima.
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.
Uma versão formatada de num
.
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 .
|
Exemplo #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
?>