(PHP 4, PHP 5, PHP 7, PHP 8)
number_format — Форматирует число с группировкой классов многозначного числа
$num,$decimals = 0,$decimal_separator = ".",$thousands_separator = ","Функция форматирует число с группировкой классов многозначного числа, и, если требуется, с десятичными разрядами. Функция применяет правило математического округления в бо́льшую сторону.
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"
It's not explicitly documented; number_format also rounds:<?php$numbers = array(0.001, 0.002, 0.003, 0.004, 0.005, 0.006, 0.007, 0.008, 0.009);foreach ($numbers as $number) print $number."->".number_format($number, 2, '.', ',')."<br>";?>0.001->0.000.002->0.000.003->0.000.004->0.000.005->0.010.006->0.010.007->0.010.008->0.010.009->0.01Note: use NumberFormatter to convert in human-readable format instead user function from comments:<?phpecho NumberFormatter::create('en', NumberFormatter::SPELLOUT)->format(12309); // twelve thousand three hundred nineecho NumberFormatter::create('ru', NumberFormatter::SPELLOUT)->format(12307.5); // двенадцать тысяч триста семь целых пять десятых?>Outputs a human readable number.<?php # Output easy-to-read numbers # by james at bandit.co.nz function bd_nice_number($n) { // first strip any formatting; $n = (0+str_replace(",","",$n)); // is this a number? if(!is_numeric($n)) return false; // now filter it; if($n>1000000000000) return round(($n/1000000000000),1).' trillion'; else if($n>1000000000) return round(($n/1000000000),1).' billion'; else if($n>1000000) return round(($n/1000000),1).' million'; else if($n>1000) return round(($n/1000),1).' thousand'; return number_format($n); }?>Outputs:247,704,360 -> 247.7 million866,965,260,000 -> 867 billionIf you want to display a number ending with ,- (like 200,-) when there are no decimal characters and display the decimals when there are decimal characters i use:function DisplayDouble($value) { list($whole, $decimals) = split ('[.,]', $value, 2); if (intval($decimals) > 0) return number_format($value,2,".",","); else return number_format($value,0,".",",") .",-"; }formatting numbers may be more easy if u use number_format function.I also wrote this :function something($number){ $locale = localeconv(); return number_format($number, $locale['frac_digits'], $locale['decimal_point'], $locale['thousands_sep']);}hope this helps =)[]'sFor Zero fill - just use the sprintf() function$pr_id = 1;$pr_id = sprintf("%03d", $pr_id);echo $pr_id;//outputs 001-----------------$pr_id = 10;$pr_id = sprintf("%03d", $pr_id);echo $pr_id;//outputs 010-----------------You can change %03d to %04d, etc.I ran across an issue where I wanted to keep the entered precision of a real value, without arbitrarily rounding off what the user had submitted.I figured it out with a quick explode on the number before formatting. I could then format either side of the decimal.<?php function number_format_unlimited_precision($number,$decimal = '.') { $broken_number = explode($decimal,$number); return number_format($broken_number[0]).$decimal.$broken_number[1]; }?>