Latest web development tutorials
 

PHP number_format() Function

< PHP String Reference

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