Класс NumberHelper

__call()source public

__call( string $method , array $params )

Вызов методов из утилиты Cake\I18n\Number

Параметры

строка $method

Метод для вызова

массив $params

Массив параметров для метода.

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

смешанное
Результат вызова метода или false при ошибке

Переопределяет

Cake\View\Helper::__call()

__construct()source public

__construct( Cake\View\View $View , array $config [] )

Конструктор по умолчанию

Настройки:

• engine Имя класса для замены функциональности Cake\I18n\Number. Класс должен быть размещён в каталоге Utility.

Параметры

Cake\View\View $View

Представление, к которому прикреплён помощник.

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

Настройки конфигурации помощника

Исключения

Cake\Core\Exception\Exception
Если класс движка не был найден.

Переопределяет

Cake\View\Helper::__construct()

currency()source public

currency( float $number , 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 - Заменить ли символ валюты международным кодом валюты.
• escape - Экранировать ли HTML в результирующей строке

Параметры

float $number

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

строка|null $currency необязательно null

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

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

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

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

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

defaultCurrency()source public

defaultCurrency( string|boolean $currency )

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

Параметры

строка|логическое $currency

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

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

строка
Валюта

format()source public

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

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

Параметры:

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

Параметры

float $number

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

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

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

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

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

Ссылка

https://book.cakephp.org/3.0/ru/views/helpers/number.html#formatting-numbers

formatDelta()source public

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

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

Параметры

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

Параметры

float $value

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

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

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

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

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

implementedEvents()source public

implementedEvents( )

Обработчики событий.

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

массив

Переопределяет

Cake\View\Helper::implementedEvents()

ordinal()source public

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

Форматирует число с использованием суффикса порядкового номера, соответствующего локали.

Параметры

integer|float $value

Целое число

array $options необязательно []

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

Возвращает

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

precision()source public

precision( float $number , integer $precision 3 )

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

Параметры

float $number

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

integer $precision необязательно 3

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

Возвращает

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

См. также

\Cake\I18n\Number::precision()

Ссылка

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

toPercentage()source public

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

Преобразует число в строку процентов.

Параметры:

• multiply: Умножает входное значение на 100 для десятичных процентов.

Параметры

float $number

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

integer $precision необязательно 2

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

array $options необязательно []

Параметры

Возвращает

string
Строка процентов

См. также

\Cake\I18n\Number::toPercentage()

Ссылка

https://book.cakephp.org/3.0/ru/views/helpers/number.html#formatting-percentages

toReadableSize()source public

toReadableSize( integer $size )

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

Параметры

integer $size

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

Возвращает

string
Размер в читаемом формате

См. также

\Cake\I18n\Number::toReadableSize()

Ссылка

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

__debugInfo()source public

__debugInfo( )

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

Возвращает

array

__get()source public

__get( string $name )

Ленично загружает помощники.

Параметры

string $name

Имя свойства, к которому осуществляется доступ.

Возвращает

Cake\View\Helper|null
Экземпляр помощника, если помощник с указанным именем существует

_confirm()source protected

_confirm( string $message , string $okCode , string $cancelCode '' , array $options [] )

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

Параметры

string $message

Сообщение для отображения

string $okCode

Код, который выполняется после выбора пользователем 'OK'

string $cancelCode необязательно ''

Код, который выполняется после выбора пользователем 'Отмена'

array $options необязательно []

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

Возвращает

string
Код JS для onclick

addClass()source public

addClass( array $options [] , string|null $class null , string $key 'class' )

Добавляет указанный класс к параметрам элемента.

Параметры

array $options необязательно []

Массив параметров/атрибутов, к которым нужно добавить класс

string|null $class необязательно null

Имя добавляемого класса.

string $key необязательно 'class'

Ключ для использования класса.

Возвращает

array
Массив параметров со значением $key.

getView()source public

getView( )

Получить экземпляр представления, к которому привязан этот помощник.

Возвращает

Cake\View\View
Экземпляр связанного представления.

initialize()source public

initialize( array $config )

Метод-обработчик конструктора.

Реализуйте этот метод, чтобы избежать необходимости перезаписывать конструктор и вызывать родительский класс.

Параметры

array $config

Параметры конфигурации, предоставленные этому помощнику.

_configDelete()source protected

_configDelete( string $key )

Удаляет один ключ конфигурации.

Параметры

string $key

Ключ для удаления.

Исключения

Cake\Core\Exception\Exception
если попытка перезаписи существующей конфигурации

_configRead()source protected

_configRead( string|null $key )

Считывает ключ конфигурации.

Параметры

string|null $key

Ключ для чтения.

Возвращает

mixed

_configWrite()source protected

_configWrite( string|array $key , mixed $value , boolean|string $merge false )

Записывает ключ конфигурации.

Параметры

string|array $key

Ключ для записи.

mixed $value

Значение для записи.

boolean|string $merge необязательно false

Истинное значение для рекурсивного слияния, 'shallow' для простого слияния, ложное значение для перезаписи, по умолчанию ложное.

Исключения

Cake\Core\Exception\Exception
если попытка перезаписи существующей конфигурации

config()source public

config( string|array|null $key null , mixed|null $value null , boolean $merge true )

Получение/Установка конфигурации.

Использование

Чтение всей конфигурации:

$this->config();

Чтение определенного значения:

$this->config('key');

Чтение вложенного значения:

$this->config('some.nested.key');

Установка определенного значения:

$this->config('key', $value);

Установка вложенного значения:

$this->config('some.nested.key', $value);

Обновление нескольких настроек конфигурации одновременно:

$this->config(['one' => 'value', 'another' => 'value']);

Устаревший

3.4.0 используйте setConfig()/getConfig() вместо этого.

Параметры

string|array|null $key необязательно null

Ключ для получения/установки или весь массив конфигураций.

mixed|null $value необязательно null

Значение для установки.

boolean $merge необязательно true

Производить рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию — true.

Возвращает

mixed
Значение конфигурации, которое считывается, или сам объект при операциях записи.

Исключения

Cake\Core\Exception\Exception
При попытке установить недопустимый ключ.

configShallow()source public

configShallow( string|array $key , mixed|null $value null )

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

Установление определенного значения:

$this->configShallow('key', $value);

Установление вложенного значения:

$this->configShallow('some.nested.key', $value);

Обновление нескольких настроек конфигурации одновременно:

$this->configShallow(['one' => 'value', 'another' => 'value']);

Параметры

string|array $key

Ключ для установки или полный массив настроек.

mixed|null $value необязательно null

Значение для установки.

Возвращает

$this

getConfig()source public

getConfig( string|null $key null , mixed $default null )

Возвращает конфигурацию.

Использование

Чтение всей конфигурации:

$this->getConfig();

Чтение определенного значения:

$this->getConfig('key');

Чтение вложенного значения:

$this->getConfig('some.nested.key');

Чтение со значением по умолчанию:

$this->getConfig('some-key', 'default-value');

Параметры

string|null $key необязательно null

Ключ для получения или null для всей конфигурации.

mixed $default необязательно null

Возвращаемое значение, когда ключ не существует.

Возвращает

mixed
Значение считываемой конфигурации.

setConfig()source public

setConfig( string|array $key , mixed|null $value null , boolean $merge true )

Устанавливает конфигурацию.

Использование

Установление определенного значения:

$this->setConfig('key', $value);

Установление вложенного значения:

$this->setConfig('some.nested.key', $value);

Обновление нескольких настроек конфигурации одновременно:

$this->setConfig(['one' => 'value', 'another' => 'value']);

Параметры

string|array $key

Ключ для установки или полный массив настроек.

mixed|null $value необязательно null

Значение для установки.

boolean $merge необязательно true

Производить рекурсивное объединение или перезапись существующей конфигурации, по умолчанию true.

Возвращает

$this

Выбрасывает

Cake\Core\Exception\Exception
При попытке установить недопустимый ключ.

[
    'engine' => 'Cake\I18n\Number'
]