number_format

    (PHP 4, PHP 5, PHP 7, PHP 8)

    number_format — Форматирует число с группировкой классов многозначного числа

    Описание

    number_format(
        float$num,
        int$decimals = 0,
        ?string$decimal_separator = ".",
        ?string$thousands_separator = ","
    ): string

    Функция форматирует число с группировкой классов многозначного числа, и, если нужно, с десятичными разрядами. Функция применяет правило математического округления в бо́льшую сторону.

    Список параметров

    num

    Форматируемое число.

    decimals

    Задаёт количество десятичных разрядов. Значение параметра decimal_separator опускается в возвращаемом значении, если в параметр передали значение 0.

    decimal_separator

    Устанавливает разделитель дробной части.

    thousands_separator

    Устанавливает разделитель классов многозначного числа.

    Возвращаемые значения

    Функция возвращает отформатированное число num.

    Список изменений

    ВерсияОписание
    8.0.0 До этой версии функция number_format() принимала один, два или четыре параметр, но не три.
    7.2.0 Функцию number_format() изменили, чтобы не возвращать значение -0. Раньше функция могла вернуть значение -0, если параметр num равнялся -0.01.

    Примеры

    Пример #1 Пример использования функции number_format()

    Во французской нотации указывают два знака: запятую «,» как десятичный разделитель и пробел « » как разделитель классов многозначных чисел. Следующий пример демонстрирует способы форматирования числа:

    <?php

    $number     = 1234.56;

    // Английский формат (по умолчанию)
    $english_format_number = number_format($number);
    // 1,235

    // Французский формат
    $nombre_format_francais = number_format($number, 2, ',', ' ');
    // 1 234,56

    $number = 1234.5678;

    // Английский формат без разделителя классов многозначного числа
    $english_format_number = number_format($number, 2, '.', '');
    // 1234.57

    ?>

    Смотрите также

    • money_format() - Форматирует число как денежную величину
    • sprintf() - Возвращает отформатированную строку
    • printf() - Выводит отформатированную строку
    • sscanf() - Разбирает строку в соответствии с заданным форматом
    To Top