Uso da função number_format () em PHP

A função number_format () é usada para formatar o número de dados. É uma função incorporada do PHP que também é usada para formatar um número com milhares agrupados. Ele retorna um valor de string com base nos parâmetros usados ​​nesta função. Os propósitos de usar diferentes parâmetros desta função e como esta função pode ser usada para formatar o número foram mostrados neste tutorial.

Sintaxe:

A função number_format () pode ser usada de duas maneiras. Duas sintaxes desta função são fornecidas abaixo:

• string number_format (float $ number [, int $ decimals = 0])

• string number_format (float $ number, int $ decimals = 0, string $ dec_point = “.”, String $ milhares_sep =“, ”) 

De acordo com as sintaxes acima, a função number_format () pode ter um, dois ou quatro argumentos. A vírgula (,) é usada como separadores de milhar padrão para ambas as sintaxes.

Quando um argumento é usado nesta função, ele recebe um número flutuante como o valor do argumento.

Quando dois valores de argumento são usados ​​nesta função, o primeiro argumento leva um número flutuante e o segundo argumento leva um número inteiro que será usado para definir o número após o ponto decimal.

Quando os quatro argumentos são usados ​​nesta função, os primeiros dois argumentos assumem os mesmos valores que os argumentos anteriores mencionados acima. Os outros dois argumentos são usados ​​para definir o ponto decimal e o separador de milhar.

Exemplo 1: use number_format () com um argumento

O exemplo a seguir mostra o uso da função number_format () com um argumento para formatar o número com o separador de milhar padrão. Crie um arquivo PHP com o seguinte script.

O script imprimirá o valor de $ numero adicionando mil separadores.

// Defina o valor numérico
$ número = 5000000;
// Imprime o valor formatado
echo "

O número após a formatação é: ".number_format ($ number)."

";
?>

Resultado:

A seguinte saída aparecerá após a execução do script do servidor web. Aqui, o número 5000000 é impresso com os separadores de milhar, e o valor é 5.000.000.

Exemplo 2: use number_format () com dois argumentos

O exemplo a seguir mostra o uso da função number_format () com dois argumentos para formatar o número com o separador de milhar padrão e o valor decimal.  Crie um arquivo PHP com o seguinte script.

Aqui, um número flutuante é usado para a formatação. A primeira função number_format () é usada com um argumento e irá imprimir a formatação padrão. A segunda função number_format () é usada com dois argumentos e 2 é usado como um valor decimal. A segunda função formatará o número pegando dois números após o ponto decimal.

// Defina o valor numérico
$ number = 35678.67345;
// Imprime o número original
echo "

O número original é: ".$ numero."

";
// Imprime o valor formatado sem valor decimal
echo "

A saída antes da formatação com valor decimal é: ".number_format ($ number)."

";
// Imprime o valor formatado com valor decimal
echo "

A saída após a formatação com valor decimal é: ".number_format ($ number, 2)."

";
?>

Resultado:

A seguinte saída aparecerá após a execução do script do servidor web. Na saída, a primeira linha mostra o valor original do número, a segunda linha mostra a formatação padrão e a terceira linha mostra o número formatado com os dois números após o ponto decimal.

Exemplo 3: use number_format () com quatro argumentos

O exemplo a seguir mostra o uso da função number_format () com quatro argumentos para formatar o número com o separador de milhar definido, ponto decimal e valor decimal.  Crie um arquivo PHP com o seguinte script.

Um número flutuante é definido no script. A função number_format () é usada duas vezes no script. Esta funçãoéusada com dois argumentos e quatro argumentos no script para mostrar o propósito de usar os quatro argumentos desta função. Quando number_format () é usado com quatro argumentos, então ',' é usado para o ponto decimal, e '.'É usado para o separador de milhar.

// Defina o valor numérico
$ number = 875620.7854;
// Imprime o número original
echo "

O número original é: ".$ numero."

";
// Imprime o valor formatado com dois argumentos
echo "

A saída após a formatação com dois argumentos é: ".number_format ($ number, 3)."

";
// Imprime o valor formatado com quatro argumentos
echo "

A saída após a formatação com quatro argumentos é: ".number_format ($ number, 3, ',', '.')."

";
?>

Resultado:

A seguinte saída aparecerá após a execução do script do servidor web. Aqui, a primeira linha mostra o valor original do número. A segunda linha mostra o número formatado com 3 dígitos após o ponto decimal, ponto decimal padrão e separadores de milhar padrão. A terceira linha mostra o número formatado com base no caractere definido no terceiro e quarto argumento da função.

Exemplo 4: formato de número com base na declaração condicional

O exemplo a seguir mostra a maneira de formatar o número com base na declaração condicional usando a função number_format (). Crie um arquivo PHP com o seguinte script.

Aqui, um número flutuante é declarado e a função explode () é usada para recuperar a parte fracionária do número. 'E se' condição é usada para verificar o número de dígitos da parte fracionária e formatar o número com base neste valor.

// Defina um número flutuante
$ number = 45.158;
// Criar array com base no ponto decimal
$ num_part = explode ('.', $ number);
// Leia o valor fracionário
$ fração = $ num_part [1];
// Conte os dígitos totais do valor fracionário
$ contagem = strlen ((string) $ fração);
// Formatar o número com base no comprimento do valor fracionário
if ($ count> = 4)
echo "O valor formatado é:".number_format ($ number, 3);
else if ($ count> = 3)
echo "O valor formatado é:".number_format ($ number, 2);
senão
echo "O valor formatado é:".number_format ($ number, 1);
?>

Resultado:

A seguinte saída aparecerá após a execução do script do servidor web. Aqui, o número contém 3 dígitos após a vírgula decimal. De acordo com o script, a segunda declaração condicional é verdadeira. Portanto, o número é formatado com 2 dígitos após o ponto decimal.

Conclusão

Diferentes usos da função number_format () foram explicados neste tutorial usando vários exemplos. Como esta função funciona para um, dois e quatro argumentos foi mostrado usando diferentes números flutuantes. Esperançosamente, os leitores serão capazes de usar esta função corretamente para formatar os números depois de ler este tutorial.