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

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.

Related Functions

Example of number_format

Show all examples for number_format

PHP Version:


Function number_format:

Strings Functions

Most used PHP functions