Класс Number

Библиотека для работы с числами.

Методы для улучшения удобочитаемости чисел.

Пространство имён: Cake\I18n
Ссылка: https://book.cakephp.org/4/ru/core-libraries/number.html

Константы

int

CURRENCY_ACCOUNTING
```
12
```
Константа ICU для бухгалтерского формата; пока не широко поддерживается библиотекой INTL. Это станет возможным после того, как минимальная версия PHP для CakePHP станет 7.4.1 или выше. См. UNUM_CURRENCY_ACCOUNTING в https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/unum_8h.html
string

DEFAULT_LOCALE
```
'en_US'
```
Локаль по умолчанию
string

FORMAT_CURRENCY
```
'currency'
```
Тип формата для отображения валюты
string

FORMAT_CURRENCY_ACCOUNTING
```
'currency_accounting'
```
Тип формата для отображения валюты в бухгалтерском стиле (отрицательные числа в скобках)

Резюме свойств

$_defaultCurrency protected static

string|null

Валюта по умолчанию, используемая в Number::currency()
$_defaultCurrencyFormat protected static

string|null

Формат валюты по умолчанию, используемый в Number::currency()
$_formatters protected static

array

Список форматирователей чисел, индексированных по локали и типу

Резюме методов

_setAttributes() protected static

Устанавливает атрибуты форматирования
config() public static

Настраивает форматирователи.
currency() public static

Форматирует число в формате валюты.
defaultCurrency() public static deprecated

Получение/установка валюты по умолчанию. Данное поведение устарело и будет удалено в будущих версиях CakePHP.
format() public static

Форматирует число в соответствии с локалью.
formatDelta() public static

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

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

Получение валюты по умолчанию
getDefaultCurrencyFormat() public static

Получение формата валюты по умолчанию
ordinal() public static

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

Разбирает локализованную строку с числом и преобразует её в число с плавающей запятой
precision() public static

Форматирует число с заданной точностью.
setDefaultCurrency() public static

Установка валюты по умолчанию
setDefaultCurrencyFormat() public static

Установка формата валюты по умолчанию
toPercentage() public static

Форматирует число в процентный формат.
toReadableSize() public static

Возвращает размер файла в удобочитаемом формате.

END_OF_DOCUMENT_MARKER

Краткое описание методов

_setAttributes() protected static

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

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

Parameters

NumberFormatter $formatter: Экземпляр форматировщика чисел.
array $options optional: См. Number::formatter() для возможных параметров.

Returns

NumberFormatter

config() public static

config(string $locale, int $type = NumberFormatter::DECIMAL, array $options = []): void

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

Parameters

string $locale: Имя локали, используемой для форматирования числа, например, fr_FR
int $type optional: Тип форматировщика для создания. По умолчанию NumberFormatter::DECIMAL.
array $options optional: См. Number::formatter() для возможных параметров.

Returns

void

currency() public static

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

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

Options

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

Parameters

float|string $value: Значение для форматирования.
string|null $currency optional: Международное название валюты, такое как 'USD', 'EUR', 'JPY', 'CAD'
array $options optional: Список параметров.

Returns

string

defaultCurrency() public static

defaultCurrency(string|false|null $currency = null): string|null

Геттер/сеттер для валюты по умолчанию. Это поведение устарело и будет удалено в будущих версиях CakePHP.

Parameters

string|false|null $currency optional: Строка валюты по умолчанию, которая будет использоваться {@link currency()}, если аргумент $currency не предоставлен. Если передано логическое значение false, текущее сохраненное значение будет очищено.

Returns

string|null

format() public static

format(float|string $value, array $options = []): string

Форматирует число в правильный формат локали

Параметры:

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

Parameters

float|string $value: Число с плавающей точкой.
array $options optional: Массив с параметрами.

Returns

string

formatDelta() public static

formatDelta(float|string $value, array $options = []): string

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

Options

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

Parameters

float|string $value: Число с плавающей точкой
array $options optional: Список параметров.

Returns

string

formatter() public static

formatter(array $options = []): NumberFormatter

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

Options

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

Parameters

array $options optional: Массив с параметрами.

Returns

NumberFormatter

getDefaultCurrency() public static

getDefaultCurrency(): string

Геттер для валюты по умолчанию

Returns

string

getDefaultCurrencyFormat() public static

getDefaultCurrencyFormat(): string

Геттер для формата валюты по умолчанию

Returns

string

ordinal() public static

ordinal(int|float $value, array $options = []): string

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

Options

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

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

Parameters

int|float $value: Целое число
array $options optional: Массив с параметрами.

Returns

string

parseFloat() public static

parseFloat(string $value, array $options = []): float

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

Параметры:

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

Parameters

string $value: Числовая строка.
array $options optional: Массив с параметрами.

Returns

float

precision() public static

precision(float|string $value, int $precision = 3, array $options = []): string

Форматирует число с заданным уровнем точности.

Параметры:

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

Parameters

float|string $value: Число с плавающей точкой.
int $precision optional: Точность возвращаемого числа.
array $options optional: Дополнительные параметры

Returns

string

Links

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

setDefaultCurrency() public static

setDefaultCurrency(string|null $currency = null): void

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

Параметры

string|null $currency опционально: Строка валюты по умолчанию, используемая методом {@link currency()}, если аргумент $currency не указан. Если передано значение null, текущее сохранённое значение будет очищено.

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

void

setDefaultCurrencyFormat() public static

setDefaultCurrencyFormat(string|null $currencyFormat = null): void

Установка формата валюты по умолчанию

Параметры

string|null $currencyFormat опционально: Формат валюты по умолчанию, используемый методом currency(), если аргумент $currencyFormat не указан. Если передано значение null, текущее сохранённое значение будет очищено.

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

void

toPercentage() public static

toPercentage(float|string $value, int $precision = 2, array $options = []): string

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

Опции:

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

Параметры

float|string $value: Число с плавающей точкой
int $precision опционально: Точность возвращаемого числа
array $options опционально: Опции

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

string

Ссылки

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

toReadableSize() public static

toReadableSize(int|string $size): string

Возвращает размер файла в читаемом для человека формате.

Параметры

int|string $size: Размер в байтах

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

string

Ссылки

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

Подробности свойств

`$_defaultCurrency` protected static

Валюта по умолчанию, используемая методом Number::currency()

Тип

string|null

`$_defaultCurrencyFormat` protected static

Формат валюты по умолчанию, используемый методом Number::currency()

Тип

string|null

`$_formatters` protected static

Список форматировщиков чисел, индексированных по локали и типу

Тип

array

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.2/class-Cake.I18n.Number.html

Класс Number

Константы

Резюме свойств

Резюме методов

_setAttributes() protected static

config() public static

currency() public static

defaultCurrency() public static deprecated

format() public static

formatDelta() public static

formatter() public static

getDefaultCurrency() public static

getDefaultCurrencyFormat() public static

ordinal() public static

parseFloat() public static

precision() public static

setDefaultCurrency() public static

setDefaultCurrencyFormat() public static

toPercentage() public static

toReadableSize() public static

Краткое описание методов

_setAttributes() protected static

Parameters

Returns

config() public static

Parameters

Returns

currency() public static

Options

Parameters

Returns

defaultCurrency() public static

Parameters

Returns

format() public static

Parameters

Returns

formatDelta() public static

Options

Parameters

Returns

formatter() public static

Options

Parameters

Returns

getDefaultCurrency() public static

Returns

getDefaultCurrencyFormat() public static

Returns

ordinal() public static

Options

Parameters

Returns

parseFloat() public static

Parameters

Returns

precision() public static

Parameters

Returns

Links

setDefaultCurrency() public static

Параметры

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

setDefaultCurrencyFormat() public static

Параметры

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

toPercentage() public static

Параметры

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

Ссылки

toReadableSize() public static

Параметры

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

Ссылки

Подробности свойств

$_defaultCurrency protected static

Тип

$_defaultCurrencyFormat protected static

Тип

$_formatters protected static

`$_defaultCurrency` protected static

`$_defaultCurrencyFormat` protected static

`$_formatters` protected static