array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.number-format.php', 1 => 'number_format', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.nl2br.php', 1 => 'nl2br', ), 'next' => array ( 0 => 'function.ord.php', 1 => 'ord', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/strings/functions/number-format.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
number_format — Format a number with grouped thousands
$num
,$decimals
= 0,$decimal_separator
= ".",$thousands_separator
= ","Formats a number with grouped thousands and optionally decimal digits using the rounding half up rule.
num
The number being formatted.
decimals
Sets the number of decimal digits.
If 0
, the decimal_separator
is
omitted from the return value.
decimal_separator
Sets the separator for the decimal point.
thousands_separator
Sets the thousands separator.
A formatted version of num
.
Versão | Descrição |
---|---|
8.0.0 | Prior to this version, number_format() accepted one, two, or four parameters (but not three). |
7.2.0 |
number_format() was changed to not being able to return
-0 , previously -0 could be returned
for cases like where num would be -0.01 .
|
Exemplo #1 number_format() Example
For instance, French notation usually use two decimals, comma (',') as decimal separator, and space (' ') as thousand separator. The following example demonstrates various ways to format a number:
<?php
$number = 1234.56;
// english notation (default)
$english_format_number = number_format($number);
// 1,235
// French notation
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56
$number = 1234.5678;
// english notation without thousands separator
$english_format_number = number_format($number, 2, '.', '');
// 1234.57
?>