Класс DateTimeWidget

__construct()source public

__construct( Cake\View\StringTemplate $templates , Cake\View\Widget\SelectBoxWidget $selectBox )

Конструктор

Параметры

Cake\View\StringTemplate $templates

Список шаблонов.

Cake\View\Widget\SelectBoxWidget $selectBox

Экземпляр виджета Selectbox.

_adjustValue()source protected

_adjustValue( integer $value , array $options )

Корректировка значения $value на основе настроек округления.

Параметры

целое $value

Значение, подлежащее корректировке.

массив $options

Параметры, содержащие интервал и, возможно, округление.

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

целое
Значение, на которое следует скорректировать $value.

_daySelect()source protected

_daySelect( array $options , Cake\View\Form\ContextInterface $context )

Генерирует выбор дня

Параметры

массив $options

Параметры для генерации выбора дня.

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

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

строка

_deconstructDate()source protected

_deconstructDate( string|integer|array|DateTime|null $value , array $options )

Декомпозирует переданное значение даты во все временные единицы

Параметры

строка|целое|массив|DateTime|null $value

Значение для декомпозиции.

массив $options

Параметры для преобразования.

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

массив

_generateNumbers()source protected

_generateNumbers( integer $start , integer $end , array $options [] )

Генерирует диапазон чисел

Параметры

• leadingZeroKey - Установить в true для добавления ведущего 0 к ключам с одной цифрой.
• leadingZeroValue - Установить в true для добавления ведущего 0 к значениям с одной цифрой.
• interval - Интервал для генерации чисел. По умолчанию 1.

Параметры

целое $start

Начало диапазона чисел для генерации

целое $end

Конец диапазона чисел для генерации

массив $options optional []

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

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

массив

_getMonthNames()source protected

_getMonthNames( boolean $leadingZero false )

Возвращает переведённый список имён месяцев

Параметры

логическое $leadingZero optional false

Указывает, нужно ли генерировать ключи месяцев с ведущим нулём.

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

массив

_hourSelect()source protected

_hourSelect( array $options , Cake\View\Form\ContextInterface $context )

Генерирует выбор часа

Параметры

массив $options

Параметры для генерации выбора часа

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

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

строка

_meridianSelect()source protected

_meridianSelect( array $options , Cake\View\Form\ContextInterface $context )

Генерирует выбор полудня

Параметры

массив $options

Параметры для генерации выбора полудня.

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

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

строка

_minuteSelect()source protected

_minuteSelect( array $options , Cake\View\Form\ContextInterface $context )

Генерирует выбор минуты

Параметры

массив $options

Параметры для генерации выбора минуты.

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

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

строка

_monthSelect()source protected

_monthSelect( array $options , Cake\View\Form\ContextInterface $context )

Генерирует выбор месяца

Параметры

массив $options

Параметры для построения выбора месяца

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

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

строка

_normalizeData()source protected

_normalizeData( array $data )

Нормализует данные.

Параметры

массив $data

Данные для нормализации.

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

массив
Нормализованные данные.

_secondSelect()source protected

_secondSelect( array $options , Cake\View\Form\ContextInterface $context )

Генерирует список выбора для секунд

Параметры

array $options

Параметры для генерации списка выбора для секунд

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

Возвращает

string

_yearSelect()source protected

_yearSelect( array $options , Cake\View\Form\ContextInterface $context )

Генерирует список выбора для года

Параметры

array $options

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

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

Возвращает

string

render()source public

render( array $data , Cake\View\Form\ContextInterface $context )

Отображает виджет даты и времени

• name - Установите имя поля ввода.
• disabled - True или массив параметров для отключения.
• val - Строка даты и времени, целое число или объект DateTime
• empty - Установите значение в true, чтобы добавить пустой элемент вверху списка параметров. Установите строковое значение, чтобы определить отображаемое значение пустого элемента.

В дополнение к вышеперечисленным параметрам, следующие параметры позволяют управлять тем, какие элементы ввода генерируются. Установив любой параметр в false, можно отключить соответствующий элемент выбора. Кроме того, каждый элемент выбора позволяет установить дополнительные параметры, которые устанавливаются в качестве HTML-атрибутов элемента выбора.

• year - Массив параметров для года.
• month - Массив параметров для месяца.
• day - Массив параметров для дня.
• hour - Массив параметров для часа.
• minute - Массив параметров для минуты.
• second - Установите значение в true, чтобы включить поле ввода секунд. По умолчанию false.
• meridian - Установите значение в true, чтобы включить поле ввода формата. По умолчанию false. Формат будет автоматически включен, если выбран 12-часовой формат.

Параметр year принимает параметры start и end. Они позволяют контролировать диапазон лет, который генерируется. По умолчанию это +/- 5 лет от текущей даты.

Параметр month принимает параметр name, который позволяет получить названия месяцев вместо номеров.

Параметр hour позволяет установить следующие параметры:

• format параметр, принимающий значения 12 или 24, позволяющий указать желаемый формат часов.
• start Час, с которого начинаются значения.
• end Час, до которого заканчиваются значения.

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

Параметр minute позволяет определить следующие параметры:

• interval Интервал для округления значений.
• round Принимает значения up или down. Определяет, в какую сторону должно быть округлено текущее значение, чтобы соответствовать значениям в списке выбора.

Параметры

array $data

Данные для отображения.

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

Возвращает

string
Сгенерированный список выбора.

Использует

RuntimeException
При невалидных данных параметров.

Реализация

Cake\View\Widget\WidgetInterface::render()

secureFields()source public

secureFields( array $data )

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

Когда поле ввода часа в 24-часовом формате (null или format=24), поле ввода формата будет опущено.

Параметры

array $data

Данные для отображения.

Возвращает

array
Массив полей для защиты.

Реализация

Cake\View\Widget\WidgetInterface::secureFields()

[
    'year',
    'month',
    'day',
    'hour',
    'minute',
    'second',
    'meridian',
]