number_format
PHP 4, PHP 5, PHP 7, PHP 8
number_format - Format a number with grouped thousands
number_format(
float$num,
[int$decimals = 0],
[string|null$decimal_separator = "."],
[string|null$thousands_separator = ","]
): string
float$num,
[int$decimals = 0],
[string|null$decimal_separator = "."],
[string|null$thousands_separator = ","]
): string
Formats a number with grouped thousands and optionally decimal digits.
Parameters
- 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.
Return Values
A formatted version of num.
Changelog
| Version | Description |
| 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. |