The number_format() function is an inbuilt function in PHP which is used to format a number with grouped thousands. It returns the formatted number on success otherwise it gives E_WARNING on failure.
Syntax:
string number_format ( $number, $decimals, $decimalpoint, $sep )
Parameters: This function accepts four parameters as mentioned above and described below:
- $number: It is required parameter which specified the number to be formatted. If no other parameters are set, the number will be formatted without decimals and with the comma (, ) as the thousands separator.
- $decimals: It is optional parameter and used to specifies decimals. If this parameter is set, the number will be formatted with a dot (.) as the decimal point.
- $decimalpoint: It is optional parameter and used to specifies the string to use for the decimal point.
- $sep: It is optional parameter and used to specifies string to use for thousands separator. If this parameter is given, then all other parameters are required.
Return Value: It returns Formatted Number in case success, otherwise it gives E_WARNING in failure.
Examples:
Input: $number = 100000
Output: 10, 000
Input: $number = 10000
$decimals = 3
$decimalpoints = "." $sep =,
Output: 10, 0000.000
Below programs illustrate The number_format() function in PHP:
Program 1:
<?php $num1 = "999999.49"; // With out decimal point parameter echo number_format($num1)."\n"; // With decimal Point parameter echo number_format($num1, 3)."\n"; $num2 = "9999999.99"; // With out decimal point parameter // return Round value echo number_format($num2)."\n"; // With decimal Point parameter echo number_format($num2, 3)."\n"; // With All four parameters echo number_format("1000000.99", 3, "#", "GGG"); ?> |
999,999 999,999.490 10,000,000 9,999,999.990 1GGG000GGG000#990
Program 2: If pass anything instead of numbers it gives warning.
<?php $num = "GFG"; // With out decimal point parameter echo number_format($num)."\n\n"; // With decimal Point parameter echo number_format($num, 3); ?> |
PHP Warning: number_format() expects parameter 1 to be float, string given in /home/ac476aaecea758334cb8ed146bcbb8f6.php on line 5 PHP Warning: number_format() expects parameter 1 to be float, string given in /home/ac476aaecea758334cb8ed146bcbb8f6.php on line 8
Program 3: This function does not accept three parameters, only accept 1, 2 or 4 parameters.
<?php $num = 1000000; // passing 3 parameters It gives errors because function // accepting only 1, 2 or 4 parameters echo number_format($num, 3, ", "); ?> |
PHP Warning: Wrong parameter count for number_format() in /home/e426108b066d9a86366249bf7b626d19.php on line 6
Reference: http://php.net/manual/en/function.number-format.php
Recommended Posts:
- How to get the function name inside a function in PHP ?
- PHP 5 vs PHP 7
- PHP | Get PHP configuration information using phpinfo()
- PHP | php.ini File Configuration
- How to import config.php file in a PHP script ?
- PHP | imagecreatetruecolor() Function
- PHP | fpassthru( ) Function
- PHP | ImagickDraw getTextAlignment() Function
- PHP | Ds\Sequence last() Function
- PHP | Imagick floodFillPaintImage() Function
- Function to escape regex patterns before applied in PHP
- PHP | array_udiff_uassoc() Function
- PHP | geoip_continent_code_by_name() Function
- PHP | GmagickPixel setcolor() function
- PHP | opendir() Function
- PHP | cal_to_jd() Function
- PHP | stream_get_transports() Function
- PHP | Ds\Deque pop() Function
- PHP | SimpleXMLElement children() Function
- PHP | array_intersect_ukey() Function
If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.
Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.

