A função number_format () é usada para formatar o número de dados. É uma função embutida 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 receber 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
$ numero = 5000000;
// Imprime o valor formatado
jogou fora '
O número após a formatação é:'. formato numérico ($ numero).'
';?>
Saída :
A seguinte saída aparecerá após a execução do script no servidor da 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 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
$ numero = 35678.67345;
// Imprime o número original
jogou fora '
O número original é:'.$ numero.'
';// Imprime o valor formatado sem valor decimal
jogou fora '
A saída antes da formatação com valor decimal é:'. formato numérico ($ numero).'
';// Imprime o valor formatado com valor decimal
jogou fora '
A saída após a formatação com valor decimal é:'. formato numérico ($ numero,2).'
';?>
Saída :
A seguinte saída aparecerá após a execução do script no servidor da 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 a vírgula 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
$ numero = 875620.7854;
// Imprime o número original
jogou fora '
O número original é:'.$ numero.'
';// Imprime o valor formatado com dois argumentos
jogou fora '
A saída após a formatação com dois argumentos é:'. formato numérico ($ numero,3).'
';// Imprime o valor formatado com quatro argumentos
jogou fora '
A saída após a formatação com quatro argumentos é:'. formato numérico ($ numero,3,',','.').'
';?>
Saída :
A seguinte saída aparecerá após a execução do script no servidor da 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 como formatar o número com base na instruçã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
$ numero = 45.158;
// Criar array com base no ponto decimal
$ num_part = explodir ('.',$ numero);
// Leia o valor fracionário
$ fração = $ num_part[1];
// Conte os dígitos totais do valor fracionário
$ count = Strlen ((fragmento)$ fração);
// Formatar o número com base no comprimento do valor fracionário
E se ($ count > = 4)
jogou fora 'O valor formatado é:'. formato numérico ($ numero, 3);
outro E se($ count > = 3)
jogou fora 'O valor formatado é:'. formato numérico ($ numero, 2);
outro
jogou fora 'O valor formatado é:'. formato numérico ($ numero, 1);
?>
Saída :
A seguinte saída aparecerá após a execução do script no servidor da 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 a vírgula decimal.
Conclusão
Diferentes usos da função number_format () foram explicados neste tutorial usando vários exemplos. Como essa 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 após a leitura deste tutorial.