Класс NumberHelper

__callsource public

__call( string $method , array $params )

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

Параметры

string $method

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

array $params

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

Возвращает

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

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

Cake\View\Helper::__call()

__constructsource public

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

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

Настройки:

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

Параметры

Cake\View\View $View

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

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

Настройки помощника

Выбрасывает

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

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

Cake\View\Helper::__construct()

currencysource public

currency( float $number , string $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

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

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

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

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

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

Возвращает

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

defaultCurrencysource public

defaultCurrency( string|boolean $currency )

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

Параметры

string|boolean $currency

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

Возвращает

string
Валюта

formatsource public

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

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

Параметры:

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

Параметры

float $number

Число с плавающей запятой.

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

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

Возвращает

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

Ссылка

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

formatDeltasource public

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

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

Параметры

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

Параметры

float $value

Число с плавающей запятой

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

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

Возвращает

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

implementedEventssource public

implementedEvents( )

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

Возвращает

array
Массив

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

Cake\View\Helper::implementedEvents()

ordinalsource public

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

Форматирует число в соответствии с порядковым суффиксом локали.

Параметры

integer|float $value

Целое число

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

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

Возвращает

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

precisionsource public

precision( float $number , integer $precision 3 )

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

Параметры

float $number

Число с плавающей запятой.

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

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

Возвращает

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

См.

Cake\I18n\Number::precision()

Ссылка

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

toPercentagesource public

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

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

Параметры:

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

Параметры

float $number

Число с плавающей запятой

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

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

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

Параметры

Возвращает

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

См.

Cake\I18n\Number::toPercentage()

Ссылка

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

toReadableSizesource public

toReadableSize( integer $size )

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

Параметры

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

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

Возвращает

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

См. также

Cake\I18n\Number::toReadableSize()

Ссылка

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

__debugInfosource public

__debugInfo( )

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

Возвращает

array
массив

__getsource public

__get( string $name )

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

Параметры

строка $name

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

Возвращает

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

_confirmsource protected

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

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

Параметры

строка $message

Сообщение, которое будет отображено

строка $okCode

Код, который будет выполнен после того, как пользователь выбрал «ОК»

строка $cancelCode необязательно ''

Код, который будет выполнен после того, как пользователь выбрал «Отмена»

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

Массив опций

Возвращает

string
JS-код onclick

addClasssource public

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

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

Параметры

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

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

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

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

строка $key необязательно 'class'

Ключ, используемый для класса.

Возвращает

array
Массив опций с установленным ключом.

_configDeletesource protected

_configDelete( string $key )

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

Параметры

строка $key

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

Исключения

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

_configReadsource protected

_configRead( string|null $key )

Чтение переменной конфигурации.

Параметры

строка|null $key

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

Возвращает

mixed
смешанный тип

_configWritesource protected

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

Запись переменной конфигурации.

Параметры

строка|массив $key

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

смешанный тип $value

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

boolean|строка $merge необязательно false

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

Исключения

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

configsource 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']);

Параметры

строка|массив|null $key необязательно null

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

смешанный тип|null $value необязательно null

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

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

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

Возвращает

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

Исключения

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

configShallowsource public

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

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

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

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

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

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

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

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

Параметры

строка|массив $key

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

смешанный тип|null $value необязательно null

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

Возвращает

mixed
Сам объект.

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

null

[]

[]

[]

null

null

[]

null

[]

false