PHP number_format() Function
Example
Format numbers:
<?php
echo number_format("1000000")."<br>";
echo number_format("1000000",2)."<br>";
echo number_format("1000000",2,",",".");
?>
Run example »
Definition and Usage
The number_format() function formats a number with grouped thousands.
Note: This function supports one, two, or four parameters (not three).
Syntax
number_format(number,decimals,decimalpoint,separator)
Parameter | Description |
---|---|
number | Required. The number to be formatted. If no other parameters are set, the number will be formatted without decimals and with comma (,) as the thousands separator. |
decimals | Optional. Specifies how many decimals. If this parameter is set, the number will be formatted with a dot (.) as decimal point |
decimalpoint | Optional. Specifies what string to use for decimal point |
separator | Optional. Specifies what string to use for thousands
separator. Only the first character of separator is used. For example, "xxx"
will give the same output as "x" Note: If this parameter is given, all other parameters are required as well |
Technical Details
Return Value: | Returns the formatted number |
---|---|
PHP Version: | 4+ |
Changelog: | As of PHP 5.4, this function supports multiple bytes in the parameters decimalpoint and separator. Only the first byte of each separator was used in older versions. |
More Examples
Example 1
You want to return a price: One parameter will round the number (it will be formatted without decimals). Two parameters should give the result you want:
<?php
$num = 1999.9;
$formattedNum = number_format($num)."<br>";
echo $formattedNum;
$formattedNum = number_format($num, 2);
echo
$formattedNum;
?>
Run example »
PHP String Reference