Класс Number

Класс Number предназначен для форматирования чисел в различных представлениях. Он предоставляет статические методы для работы с числами, включая форматирование с разделителями, преобразование в валюту, отображение размеров файлов и многое другое. Класс доступен через фасад Number или глобальную функцию number.

Синтаксис

<?php
	use Illuminate\Support\Number;
	
	Number::format($number, $precision, $locale);
?>

Метод format принимает число для форматирования, точность (количество знаков после запятой) и локаль.

Пример

Давайте отформатируем число с двумя знаками после запятой:

<?php
	use Illuminate\Support\Number;
	
	$number = 1234567.89;
	$res = Number::format($number, 2);
	
	echo $res;
?>

Результат выполнения кода:

"1,234,567.89"

Пример

Давайте отформатируем число в немецкой локали:

<?php
	use Illuminate\Support\Number;
	
	$number = 1234567.89;
	$res = Number::format($number, 2, 'de');
	
	echo $res;
?>

Результат выполнения кода:

"1.234.567,89"

Метод currency

Метод currency форматирует число в денежную единицу указанной валюты:

<?php
	use Illuminate\Support\Number;
	
	$price = 1999.99;
	$res = Number::currency($price, 'USD');
	
	echo $res;
?>

Результат выполнения кода:

"$1,999.99"

Пример

Давайте отформатируем цену в евро с использованием локали:

<?php
	use Illuminate\Support\Number;
	
	$price = 2999.50;
	$res = Number::currency($price, 'EUR', 'de');
	
	echo $res;
?>

Результат выполнения кода:

"2.999,50 €"

Метод fileSize

Метод fileSize преобразует размер в байтах в человекочитаемый формат:

<?php
	use Illuminate\Support\Number;
	
	$size = 1024 * 1024 * 2.5;
	$res = Number::fileSize($size);
	
	echo $res;
?>

Результат выполнения кода:

"2.5 MB"

Пример

Давайте отобразим размер файла с точностью до одного знака:

<?php
	use Illuminate\Support\Number;
	
	$size = 1536000;
	$res = Number::fileSize($size, 1);
	
	echo $res;
?>

Результат выполнения кода:

"1.5 MB"

Метод ordinal

Метод ordinal возвращает порядковое числительное на английском языке:

<?php
	use Illuminate\Support\Number;
	
	$numbers = [1, 2, 3, 4, 5];
	$res = [];
	
	foreach ($numbers as $num) {
		$res[] = Number::ordinal($num);
	}
	
	print_r($res);
?>

Результат выполнения кода:

["1st", "2nd", "3rd", "4th", "5th"]

Метод percentage

Метод percentage форматирует число в процентное представление:

<?php
	use Illuminate\Support\Number;
	
	$value = 0.1567;
	$res = Number::percentage($value);
	
	echo $res;
?>

Результат выполнения кода:

"15.67%"

Метод spell

Метод spell преобразует число в словесную форму на английском языке:

<?php
	use Illuminate\Support\Number;
	
	$number = 1234;
	$res = Number::spell($number);
	
	echo $res;
?>

Результат выполнения кода:

"one thousand two hundred thirty-four"

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

класс Str,
который предоставляет методы для работы со строками
класс Collection,
который предоставляет методы для работы с коллекциями
класс Arr,
который предоставляет методы для работы с массивами
класс Date,
который предоставляет методы для работы с датами