Форматирует число с разделением групп

Описание

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

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

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

num: Форматируемое число.
decimals: Устанавливает число знаков после запятой. Если 0, decimal_separator опускается в возвращаемом значении.
decimal_separator: Устанавливает разделитель дробной части.
thousands_separator: Устанавливает разделитель тысяч.

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

Отформатированное число num.

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

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

Примеры

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

Во Франции обычно используются 2 знака после запятой (','), и пробел (' ') в качестве разделителя групп. Этот пример демонстрирует различные способы форматирования чисел:

<?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() - Разбирает строку в соответствии с заданным форматом