PHP Manual
Prev |  | Next

# number_format

(PHP 3, PHP 4 )

number_format -- Format a number with grouped thousands

## Description

string number_format ( float number [, int decimals [, string dec_point [, string thousands_sep]]])

number_format() returns a formatted version of `number`. This function accepts either one, two or four parameters (not three):

If only one parameter is given, `number` will be formatted without decimals, but with a comma (",") between every group of thousands.

If two parameters are given, `number` will be formatted with `decimals` decimals with a dot (".") in front, and a comma (",") between every group of thousands.

If all four parameters are given, `number` will be formatted with `decimals` decimals, `dec_point` instead of a dot (".") before the decimals and `thousands_sep` instead of a comma (",") between every group of thousands.

> Note: Only the first character of `thousands_sep` is used. For example, if you use `foo` as `thousands_sep` on the number `1000`, number_format() will return `1f000`.

Example 1. number_format() Example

For instance, French notation usually use two decimals, comma (',') as decimal separator, and space (' ') as thousand separator. This is achieved with this line :

    <?php

        $number = 1234.56;

        // english notation (default)
        $english_format_number = number_format($number);
        // 1,234.56

        // French notation
        $nombre_format_francais = number_format($number, 2, ',', ' ');
        // 1 234,56

        $number = 1234.5678;

        // english notation without thousands seperator
        $english_format_number = number_format($number, 2, '.', '');
        // 1234.57

    ?>

See also: sprintf(), printf() and sscanf().

Prev | Home | Next
nl2br | Up | ord