DateTimeDatelistWidget.php

Same filename and directory in other branches
  1. 9 core/modules/datetime/src/Plugin/Field/FieldWidget/DateTimeDatelistWidget.php
  2. 8.9.x core/modules/datetime/src/Plugin/Field/FieldWidget/DateTimeDatelistWidget.php
  3. 11.x core/modules/datetime/src/Plugin/Field/FieldWidget/DateTimeDatelistWidget.php

Namespace

Drupal\datetime\Plugin\Field\FieldWidget

File

core/modules/datetime/src/Plugin/Field/FieldWidget/DateTimeDatelistWidget.php

View source
<?php

namespace Drupal\datetime\Plugin\Field\FieldWidget;

use Drupal\Core\Field\Attribute\FieldWidget;
use Drupal\Core\Field\FieldItemListInterface;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\StringTranslation\TranslatableMarkup;

/**
 * Plugin implementation of the 'datetime_datelist' widget.
 */
class DateTimeDatelistWidget extends DateTimeWidgetBase {
  
  /**
   * {@inheritdoc}
   */
  public static function defaultSettings() {
    return [
      'increment' => '15',
      'date_order' => 'YMD',
      'time_type' => '24',
    ] + parent::defaultSettings();
  }
  
  /**
   * {@inheritdoc}
   */
  public function formElement(FieldItemListInterface $items, $delta, array $element, array &$form, FormStateInterface $form_state) {
    $element = parent::formElement($items, $delta, $element, $form, $form_state);
    // Wrap all of the select elements with a fieldset.
    $element['#theme_wrappers'][] = 'fieldset';
    $date_order = $this->getSetting('date_order');
    if ($this->getFieldSetting('datetime_type') == 'datetime') {
      $time_type = $this->getSetting('time_type');
      $increment = $this->getSetting('increment');
    }
    else {
      $time_type = '';
      $increment = '';
    }
    // Set up the date part order array.
    $date_part_order = match ($date_order) {  'YMD' => [
        'year',
        'month',
        'day',
      ],
      'MDY' => [
        'month',
        'day',
        'year',
      ],
      'DMY' => [
        'day',
        'month',
        'year',
      ],
    
    };
    $date_part_order = match ($time_type) {  '24' => array_merge($date_part_order, [
        'hour',
        'minute',
      ]),
      '12' => array_merge($date_part_order, [
        'hour',
        'minute',
        'ampm',
      ]),
      default => $date_part_order,
    
    };
    $element['value'] = [
      '#type' => 'datelist',
      '#date_increment' => $increment,
      '#date_part_order' => $date_part_order,
    ] + $element['value'];
    return $element;
  }
  
  /**
   * {@inheritdoc}
   */
  public function settingsForm(array $form, FormStateInterface $form_state) {
    $element = parent::settingsForm($form, $form_state);
    $element['date_order'] = [
      '#type' => 'select',
      '#title' => $this->t('Date part order'),
      '#default_value' => $this->getSetting('date_order'),
      '#options' => [
        'MDY' => $this->t('Month/Day/Year'),
        'DMY' => $this->t('Day/Month/Year'),
        'YMD' => $this->t('Year/Month/Day'),
      ],
    ];
    if ($this->getFieldSetting('datetime_type') == 'datetime') {
      $element['time_type'] = [
        '#type' => 'select',
        '#title' => $this->t('Time type'),
        '#default_value' => $this->getSetting('time_type'),
        '#options' => [
          '24' => $this->t('24 hour time'),
          '12' => $this->t('12 hour time'),
        ],
      ];
      $element['increment'] = [
        '#type' => 'select',
        '#title' => $this->t('Time increments'),
        '#default_value' => $this->getSetting('increment'),
        '#options' => [
          1 => $this->t('1 minute'),
          5 => $this->t('@count minutes', [
            '@count' => 5,
          ]),
          10 => $this->t('@count minutes', [
            '@count' => 10,
          ]),
          15 => $this->t('@count minutes', [
            '@count' => 15,
          ]),
          30 => $this->t('@count minutes', [
            '@count' => 30,
          ]),
        ],
      ];
    }
    else {
      $element['time_type'] = [
        '#type' => 'hidden',
        '#value' => 'none',
      ];
      $element['increment'] = [
        '#type' => 'hidden',
        '#value' => $this->getSetting('increment'),
      ];
    }
    return $element;
  }
  
  /**
   * {@inheritdoc}
   */
  public function settingsSummary() {
    $summary = [];
    $summary[] = $this->t('Date part order: @order', [
      '@order' => $this->getSetting('date_order'),
    ]);
    if ($this->getFieldSetting('datetime_type') == 'datetime') {
      $summary[] = $this->t('Time type: @time_type', [
        '@time_type' => $this->getSetting('time_type'),
      ]);
      $summary[] = $this->t('Time increments: @increment', [
        '@increment' => $this->getSetting('increment'),
      ]);
    }
    return $summary;
  }

}

Classes

Title Deprecated Summary
DateTimeDatelistWidget Plugin implementation of the 'datetime_datelist' widget.

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