Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

number_format()

Formata um número como texto com agrupamento e arredondamento das metades para longe de zero.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

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

Formata um número como texto com agrupamento e arredondamento das metades para longe de zero. Indique separadores, um separador de grupos vazio desativa o agrupamento. Desde o PHP 8.3 casas negativas arredondam antes da vírgula. O resultado é para apresentação.

Assinatura

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

Saída do exemplo

["1 234,50","1300","1.3"]

Exemplos

<?php
echo json_encode([number_format(1234.5,2,","," "),number_format(1299,-2,".",""),number_format(1.25,1)]);

Resultado

["1 234,50","1300","1.3"]

Fontes