array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.number-format.php', 1 => 'number_format', 2 => 'Форматирует число с группировкой классов многозначного числа', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Функции для работы со строками', ), 'prev' => array ( 0 => 'function.nl2br.php', 1 => 'nl2br', ), 'next' => array ( 0 => 'function.ord.php', 1 => 'ord', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/strings/functions/number-format.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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. Начиная с PHP 8.3.0 при отрицательном значении аргумента число num округляется до заданного в параметре decimals количества значащих чисел перед десятичной точкой. До PHP 8.3.0 функция игнорировала отрицательные значения и обрабатывала их как 0.

decimal_separator

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

thousands_separator

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

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

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

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

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

Примеры

Пример #1 Пример округления числа функцией number_format()

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

<?php

$number = 1234.56;

// Английская нотация (по умолчанию)
echo number_format($number), PHP_EOL;
// 1,235

// Французская нотация
echo number_format($number, 2, ',', ' '), PHP_EOL;
// 1 234,56

$number = 1234.5678;

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

?>

Пример #2 Пример форматирования числа с отрицательным значением в аргументе decimals

Начиная с PHP 8.3.0 отрицательное значение аргумента decimals округляет число до заданного количества значащих чисел перед десятичной точкой.

<?php

$number = "1234.5678";

var_dump(number_format($number, -1));
var_dump(number_format($number, -2));
var_dump(number_format($number, -3));

?>

Результат выполнения приведённого примера: 

string(5) "1,230"
string(5) "1,200"
string(5) "1,000"

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