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
