function Date::buildOptionsForm

Same name in this branch
  1. 11.x core/modules/views/src/Plugin/views/sort/Date.php \Drupal\views\Plugin\views\sort\Date::buildOptionsForm()
Same name in other branches
  1. 9 core/modules/views/src/Plugin/views/sort/Date.php \Drupal\views\Plugin\views\sort\Date::buildOptionsForm()
  2. 9 core/modules/views/src/Plugin/views/field/Date.php \Drupal\views\Plugin\views\field\Date::buildOptionsForm()
  3. 8.9.x core/modules/views/src/Plugin/views/sort/Date.php \Drupal\views\Plugin\views\sort\Date::buildOptionsForm()
  4. 8.9.x core/modules/views/src/Plugin/views/field/Date.php \Drupal\views\Plugin\views\field\Date::buildOptionsForm()
  5. 10 core/modules/views/src/Plugin/views/sort/Date.php \Drupal\views\Plugin\views\sort\Date::buildOptionsForm()
  6. 10 core/modules/views/src/Plugin/views/field/Date.php \Drupal\views\Plugin\views\field\Date::buildOptionsForm()

Overrides FieldPluginBase::buildOptionsForm

File

core/modules/views/src/Plugin/views/field/Date.php, line 96

Class

Date
A handler to provide proper displays for dates.

Namespace

Drupal\views\Plugin\views\field

Code

public function buildOptionsForm(&$form, FormStateInterface $form_state) {
    $date_formats = [];
    foreach ($this->dateFormatStorage
        ->loadMultiple() as $machine_name => $value) {
        $date_formats[$machine_name] = $this->t('@name format: @date', [
            '@name' => $value->label(),
            '@date' => $this->dateFormatter
                ->format($this->time
                ->getRequestTime(), $machine_name),
        ]);
    }
    $form['date_format'] = [
        '#type' => 'select',
        '#title' => $this->t('Date format'),
        '#options' => $date_formats + [
            'custom' => $this->t('Custom'),
            'raw time ago' => $this->t('Time ago'),
            'time ago' => $this->t('Time ago (with "ago" appended)'),
            'raw time hence' => $this->t('Time hence'),
            'time hence' => $this->t('Time hence (with "hence" appended)'),
            'raw time span' => $this->t('Time span (future dates have "-" prepended)'),
            'inverse time span' => $this->t('Time span (past dates have "-" prepended)'),
            'time span' => $this->t('Time span (with "ago/hence" appended)'),
        ],
        '#default_value' => $this->options['date_format'] ?? 'small',
    ];
    $form['custom_date_format'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Custom date format'),
        '#description' => $this->t('If "Custom", see <a href="https://www.php.net/manual/datetime.format.php#refsect1-datetime.format-parameters" target="_blank">the PHP docs</a> for date formats. Otherwise, enter the number of different time units to display, which defaults to 2.'),
        '#default_value' => $this->options['custom_date_format'] ?? '',
    ];
    // Setup #states for all possible date_formats on the custom_date_format form element.
    foreach ([
        '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'][] = [
            ':input[name="options[date_format]"]' => [
                'value' => $custom_date_possible,
            ],
        ];
    }
    $form['timezone'] = [
        '#type' => 'select',
        '#title' => $this->t('Timezone'),
        '#description' => $this->t('Timezone to be used for date output.'),
        '#options' => [
            '' => $this->t('- Default site/user timezone -'),
        ] + TimeZoneFormHelper::getOptionsListByRegion(),
        '#default_value' => $this->options['timezone'],
    ];
    foreach (array_merge([
        'custom',
    ], array_keys($date_formats)) as $timezone_date_formats) {
        $form['timezone']['#states']['visible'][] = [
            ':input[name="options[date_format]"]' => [
                'value' => $timezone_date_formats,
            ],
        ];
    }
    parent::buildOptionsForm($form, $form_state);
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.