Класс Number

_setAttributes()source protected static

_setAttributes( NumberFormatter $formatter , array $options [] )

Устанавливает атрибуты форматировщика

Параметры

NumberFormatter $formatter

Экземпляр форматировщика чисел.

array $options optional []

См. Number::formatter() для возможных параметров.

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

NumberFormatter

config()source public static

config( string $locale , integer $type Cake\I18n\NumberFormatter::DECIMAL , array $options [] )

Настройка форматировщиков.

Параметры

string $locale

Имя локали для форматирования числа, например fr_FR

integer $type optional Cake\I18n\NumberFormatter::DECIMAL

Тип форматировщика для создания. По умолчанию NumberFormatter::DECIMAL.

array $options optional []

См. Number::formatter() для возможных параметров.

currency()source public static

currency( float $value , string|null $currency null , array $options [] )

Форматирует число в формате валюты.

Параметры

• locale - Имя локали для форматирования числа, например fr_FR
• fractionSymbol - Символ валюты для дробных чисел.
• fractionPosition - Позиция символа дроби, допустимые значения: 'before' и 'after'.
• before - Текст, отображаемый перед отформатированным числом
• after - Текст, отображаемый после отформатированного числа
• zero - Текст для нулевых значений, может быть строкой или числом. Например, 0, 'Бесплатно!'
• places - Количество десятичных знаков. Например, 2
• precision - Максимальное количество десятичных знаков, например 2
• pattern - Шаблон ICU для форматирования числа, например #,###.00
• useIntlCode - Нужно ли заменять символ валюты международным кодом валюты.

Параметры

float $value

Значение для форматирования.

string|null $currency optional null

Международное название валюты, например 'USD', 'EUR', 'JPY', 'CAD'

array $options optional []

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

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

string
Число, отформатированное как валюта.

defaultCurrency()source public static

defaultCurrency( string|boolean|null $currency null )

Получение/установка значения по умолчанию для валюты

Параметры

string|boolean|null $currency optional null

Строка валюты по умолчанию, используемая методом currency(), если аргумент $currency не указан. Если передать false, текущее сохранённое значение будет удалено.

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

string|null
Валюта

format()source public static

format( float $value , array $options [] )

Форматирует число в соответствии с локалью

Параметры:

• places - Минимальное количество десятичных знаков, например 0
• precision - Максимальное количество десятичных знаков, например 2
• pattern - Шаблон ICU для форматирования числа, например #,###.00
• locale - Имя локали для форматирования числа, например fr_FR
• before - Строка, вставляемая перед целыми числами, например '['
• after - Строка, вставляемая после дробных чисел, например ']'

Параметры

float $value

Число с плавающей точкой.

array $options optional []

Массив с параметрами.

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

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

formatDelta()source public static

formatDelta( float $value , array $options [] )

Форматирует число в соответствии с локалью для отображения разницы (знаковых разностей значений).

Параметры

• places - Минимальное количество десятичных знаков, например 0
• precision - Максимальное количество десятичных знаков, например 2
• locale - Имя локали для форматирования числа, например fr_FR
• before - Строка, вставляемая перед целыми числами, например '['
• after - Строка, вставляемая после дробных чисел, например ']'

Параметры

float $value

Число с плавающей точкой

array $options optional []

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

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

string
Отформатированная разница

formatter()source public static

formatter( array $options [] )

Возвращает объект форматировщика, который может быть повторно использован для аналогичных задач форматирования в рамках одного региона и параметров. Это часто более быстрый вариант, чем использование других методов в этом классе, так как нужно создать только один объект форматировщика.

Параметры

• locale - Имя региона, которое следует использовать для форматирования числа, например, fr_FR
• type - Тип форматировщика для создания, установите его в значение currency, если необходимо форматировать числа, представляющие денежные значения, или константу NumberFormatter.
• places - Количество десятичных знаков для использования. Например, 2
• precision - Максимальное количество десятичных знаков для использования, например, 2
• pattern - Шаблон числа ICU для использования при форматировании числа. Например, #,###.00
• useIntlCode - Нужно ли заменять символ валюты международным кодом валюты.

Параметры

массив $options необязательный []

Массив с параметрами.

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

NumberFormatter
Настроенный экземпляр форматировщика

ordinal()source public static

ordinal( integer|float $value , array $options [] )

Возвращает отформатированное целое число в виде строки порядкового номера (например, 1-е, 2-е, 3-е, 4-е, [...])

Параметры

• type - Тип форматировщика для создания, установите его в значение currency, если необходимо форматировать числа, представляющие денежные значения, или константу NumberFormatter.

Для всех остальных параметров см. formatter().

Параметры

целое число/число с плавающей точкой $value

Целое число

массив $options необязательный []

Массив с параметрами.

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

строка

parseFloat()source public static

parseFloat( string $value , array $options [] )

Парсит локализованную строку с числом и преобразует её в число с плавающей точкой

Параметры:

• locale - Имя региона, которое следует использовать для разбора числа, например, fr_FR
• type - Тип форматировщика для создания, установите его в значение currency, если необходимо анализировать числа, представляющие денежные значения.

Параметры

строка $value

Строка с числом.

массив $options необязательный []

Массив с параметрами.

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

число с плавающей точкой
число

precision()source public static

precision( float $value , integer $precision 3 , array $options [] )

Форматирует число с заданной точностью.

Параметры:

• locale: Имя региона, которое следует использовать для форматирования числа, например, fr_FR

Параметры

число с плавающей точкой $value

Число с плавающей точкой.

целое число $precision необязательный 3

Точность возвращаемого числа.

массив $options необязательный []

Дополнительные параметры

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

строка
Отформатированное число с плавающей точкой.

Ссылка

https://book.cakephp.org/3.0/ru/core-libraries/number.html#formatting-floating-point-numbers

toPercentage()source public static

toPercentage( float $value , integer $precision 2 , array $options [] )

Форматирует число в строку процента.

Параметры:

• multiply: Умножить входное значение на 100 для десятичных процентов.
• locale: Имя региона, которое следует использовать для форматирования числа, например, fr_FR

Параметры

число с плавающей точкой $value

Число с плавающей точкой

целое число $precision необязательный 2

Точность возвращаемого числа

массив $options необязательный []

Параметры

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

строка
Строка процента

Ссылка

https://book.cakephp.org/3.0/ru/core-libraries/number.html#formatting-percentages

toReadableSize()source public static

toReadableSize( integer $size )

Возвращает размер файла в формате, понятном человеку.

Параметры

целое число $size

Размер в байтах

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

строка
Человеко-понятный размер

Ссылка

https://book.cakephp.org/3.0/ru/core-libraries/number.html#interacting-with-human-readable-values

[]