function views_handler_field_date::options_form

Default options form that provides the label widget that all fields should have.

Overrides views_handler_field::options_form

File

core/modules/views/handlers/views_handler_field_date.inc, line 26

Definition of views_handler_field_date.

Class

views_handler_field_date

A handler to provide proper displays for dates.

Code

function options_form(&$form, &$form_state) {

  $date_formats = array();
  $date_types = system_get_date_formats();
  foreach ($date_types as $machine_name => $date_type) {
    $date_formats[$machine_name] = $date_type['label'] . ': ' . format_date(REQUEST_TIME, $machine_name);
  }

  $form['date_format'] = array(
    '#type' => 'select',
    '#title' => t('Date format'),
    '#options' => $date_formats + array(
      'custom' => t('Custom'),
      'raw time ago' => t('Time ago'),
      'time ago' => t('Time ago (with "ago" appended)'),
      'raw time hence' => t('Time hence'),
      'time hence' => t('Time hence (with "hence" appended)'),
      'raw time span' => t('Time span (future dates have "-" prepended)'),
      'inverse time span' => t('Time span (past dates have "-" prepended)'),
      'time span' => t('Time span (with "ago/hence" appended)'),
    ),
    '#default_value' => isset($this->options['date_format']) ? $this->options['date_format'] : 'short',
  );
  $form['custom_date_format'] = array(
    '#type' => 'textfield',
    '#title' => t('Custom date format'),
    '#description' => t('If "Custom", see the <a href="@url" target="_blank">PHP manual</a> for available options. Otherwise, enter the number of different time units to display, which defaults to 2.', array('@url' => 'https://www.php.net/manual/datetime.format.php#refsect1-datetime.format-parameters')),
    '#default_value' => isset($this->options['custom_date_format']) ? $this->options['custom_date_format'] : '',
  );
  $form['timezone'] = array(
    '#type' => 'select',
    '#title' => t('Timezone'),
    '#description' => t('Timezone to be used for date output.'),
    '#options' => array('' => t('- Default site/user timezone -')) + system_time_zones(FALSE),
    '#default_value' => $this->options['timezone'],
  );
  // Setup #states for all possible date_formats on the custom_date_format form element.
  foreach (array('custom', 'raw time ago', 'time ago', 'raw time hence', 'time hence', 'raw time span', 'time span', 'raw time span', 'inverse time span', 'time span') as $custom_date_possible) {
    $form['custom_date_format']['#states']['visible'][] = array(
      ':input[name="options[date_format]"]' => array('value' => $custom_date_possible),
    );
  }
  parent::options_form($form, $form_state);
}