Cake\View\Helper\FormHelper::dateTime PHP Method

dateTime() public method

### Date Options: - empty - If true, the empty select option is shown. If a string, that string is displayed as the empty element. - value | default The default value to be used by the input. A value in $this->data matching the field name will override this value. If no default is provided time() will be used. - monthNames If false, 2 digit numbers will be used instead of text. If an array, the given array will be used. - minYear The lowest year to use in the year select - maxYear The maximum year to use in the year select - orderYear - Order of year values in select options. Possible values 'asc', 'desc'. Default 'desc'. ### Time options: - empty - If true, the empty select option is shown. If a string, - value | default The default value to be used by the input. A value in $this->data matching the field name will override this value. If no default is provided time() will be used. - timeFormat The time format to use, either 12 or 24. - interval The interval for the minutes select. Defaults to 1 - round - Set to up or down if you want to force rounding in either direction. Defaults to null. - second Set to true to enable seconds drop down. To control the order of inputs, and any elements/content between the inputs you can override the dateWidget template. By default the dateWidget template is: {{month}}{{day}}{{year}}{{hour}}{{minute}}{{second}}{{meridian}}
public dateTime ( string $fieldName, array $options = [] ) : string
$fieldName string Prefix name for the SELECT element
$options array Array of Options
return string Generated set of select boxes for the date and time formats chosen.
    public function dateTime($fieldName, array $options = [])
    {
        $options += ['empty' => true, 'value' => null, 'interval' => 1, 'round' => null, 'monthNames' => true, 'minYear' => null, 'maxYear' => null, 'orderYear' => 'desc', 'timeFormat' => 24, 'second' => false];
        $options = $this->_initInputField($fieldName, $options);
        $options = $this->_datetimeOptions($options);
        return $this->widget('datetime', $options);
    }

Usage Example

 /**
  * Returns a set of SELECT elements for a full datetime setup: day, month and year, and then time.
  *
  * ### Date Options:
  *
  * - `empty` - If true, the empty select option is shown. If a string,
  *   that string is displayed as the empty element.
  * - `value` | `default` The default value to be used by the input. A value in `$this->data`
  *   matching the field name will override this value. If no default is provided `time()` will be used.
  * - `monthNames` If false, 2 digit numbers will be used instead of text.
  *   If an array, the given array will be used.
  * - `minYear` The lowest year to use in the year select
  * - `maxYear` The maximum year to use in the year select
  * - `orderYear` - Order of year values in select options.
  *   Possible values 'asc', 'desc'. Default 'desc'.
  *
  * ### Time options:
  *
  * - `empty` - If true, the empty select option is shown. If a string,
  * - `value` | `default` The default value to be used by the input. A value in `$this->data`
  *   matching the field name will override this value. If no default is provided `time()` will be used.
  * - `timeFormat` The time format to use, either 12 or 24.
  * - `interval` The interval for the minutes select. Defaults to 1
  * - `round` - Set to `up` or `down` if you want to force rounding in either direction. Defaults to null.
  * - `second` Set to true to enable seconds drop down.
  *
  * To control the order of inputs, and any elements/content between the inputs you
  * can override the `dateWidget` template. By default the `dateWidget` template is:
  *
  * `{{month}}{{day}}{{year}}{{hour}}{{minute}}{{second}}{{meridian}}`
  *
  * @param string $fieldName Prefix name for the SELECT element
  * @param array $options Array of Options
  * @return string Generated set of select boxes for the date and time formats chosen.
  * @link http://book.cakephp.org/3.0/en/views/helpers/form.html#creating-date-and-time-inputs
  */
 public function dateTime($fieldName, array $options = [])
 {
     $fields = ['year' => true, 'month' => true, 'day' => true, 'hour' => true, 'minute' => true, 'second' => false, 'timeFormat' => false];
     $this->templates(['dateWidget' => $this->_getDatetimeTemplate($fields, $options)]);
     return parent::dateTime($fieldName, $options);
 }
All Usage Examples Of Cake\View\Helper\FormHelper::dateTime