Number Helper

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

• Загрузка этого помощника
• Что делать, если возникнут проблемы
• Доступные функции

Загрузка этого помощника

Этот помощник загружается с помощью следующего кода:

helper('number');

Что делать, если возникнут проблемы

Если логика интернационализации и локализации PHP не может обработать предоставленное значение для заданной локали и параметров, будет выброшено исключение BadFunctionCallException().

Доступные функции

Доступны следующие функции:

number_to_size($num[, $precision = 1[, $locale = null])

Параметры:	$num (mixed) – Количество байтов $precision (int) – Точность с плавающей запятой
Возвращает:	Строка отформатированного размера данных или false, если предоставленное значение не является числовым
Тип возвращаемого значения:	string

Форматирует числа как байты, основываясь на размере и добавляет соответствующий суффикс. Примеры:

echo number_to_size(456); // Returns 456 Bytes
echo number_to_size(4567); // Returns 4.5 KB
echo number_to_size(45678); // Returns 44.6 KB
echo number_to_size(456789); // Returns 447.8 KB
echo number_to_size(3456789); // Returns 3.3 MB
echo number_to_size(12345678912345); // Returns 1.8 GB
echo number_to_size(123456789123456789); // Returns 11,228.3 TB

Необязательный второй параметр позволяет установить точность результата:

echo number_to_size(45678, 2); // Returns 44.61 KB

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

// Generates 11.2 TB
echo number_to_size(12345678912345, 1, 'en_US');
// Generates 11,2 TB
echo number_to_size(12345678912345, 1, 'fr_FR');

Примечание

Текст, сгенерированный этой функцией, находится в следующем файле языка: language/<your_lang>/Number.php

number_to_amount($num[, $precision = 1[, $locale = null])

Параметры:	$num (mixed) – Число для форматирования $precision (int) – Точность с плавающей запятой $locale (string) – Локаль для форматирования
Возвращает:	Человекопонятная версия строки, например, 123,4 триллиона для чисел до квадриллионов. Или false, если предоставленное значение не является числовым
Тип возвращаемого значения:	string

Преобразует число в удобочитаемую версию, например, 123,4 триллиона для чисел до квадриллионов. Примеры:

echo number_to_amount(123456); // Returns 123 thousand
echo number_to_amount(123456789); // Returns 123 million
echo number_to_amount(1234567890123, 2); // Returns 1.23 trillion
echo number_to_amount('123,456,789,012', 2); // Returns 123.46 billion

Необязательный второй параметр позволяет установить точность результата:

echo number_to_amount(45678, 2); // Returns 45.68 thousand

Необязательный третий параметр позволяет указать локаль:

echo number_to_amount('123,456,789,012', 2, 'de_DE'); // Returns 123,46 billion

number_to_currency($num, $currency[, $locale = null])

Параметры:	$num (mixed) – Число для форматирования $currency (string) – Тип валюты, например, USD, EUR и т.д. $locale (string) – Локаль для форматирования $fraction (integer) – Количество цифр дробной части после запятой
Возвращает:	Число в соответствующем валютном формате для локали
Тип возвращаемого значения:	string

Преобразует число в обычный валютный формат, такие как USD, EUR, GBP и т. д.:

echo number_to_currency(1234.56, 'USD');  // Returns $1,234.56
echo number_to_currency(1234.56, 'EUR');  // Returns €1,234.56
echo number_to_currency(1234.56, 'GBP');  // Returns £1,234.56
echo number_to_currency(1234.56, 'YEN');  // Returns YEN1,234.56

number_to_roman($num)

Параметры:	$num (string) – Число для преобразования
Возвращает:	Преобразованное римское число из заданного параметра
Тип возвращаемого значения:	string|null

Преобразует число в римское:

echo number_to_roman(23);  // Returns XXIII
echo number_to_roman(324);  // Returns CCCXXIV
echo number_to_roman(2534);  // Returns MMDXXXIV

Эта функция обрабатывает только числа в диапазоне от 1 до 3999. Для значений за пределами этого диапазона она вернёт null.