PHP number_format() Function

Example

Format numbers:

<?php
echo number_format("1000000")."<br>";
echo number_format("1000000",2)."<br>";
echo number_format("1000000",2,",",".");
?>

Try it Yourself »

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 Values

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

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;
?>

Try it Yourself »

❮ PHP String Reference