Issue #2161337 by mpdonadio, darrick, swentel, effulgentsia, YesCT, xjm,...

- Jonathan Hedstrom 'jhedstrom' https://www.drupal.org/u/jhedstrom

- Matthew Donadio 'mpdonadio' https://www.drupal.org/u/mpdonadio

DateTime range module

- Jonathan Hedstrom 'jhedstrom' https://www.drupal.org/u/jhedstrom

- Matthew Donadio 'mpdonadio' https://www.drupal.org/u/mpdonadio

Dynamic Page Cache module

- Fabian Franz 'Fabianx' https://www.drupal.org/u/fabianx

- Wim Leers 'Wim Leers' https://www.drupal.org/u/wim-leers

        "drupal/core-utility": "self.version",

        "drupal/core-uuid": "self.version",

        "drupal/datetime": "self.version",

        "drupal/datetime_range": "self.version",

        "drupal/dblog": "self.version",

        "drupal/dynamic_page_cache": "self.version",

        "drupal/editor": "self.version",

# Schema for the configuration files of the Datetime Range module.

# Daterange field type.

field.storage_settings.daterange:

  type: field.storage_settings.datetime

  label: 'Date range settings'

field.field_settings.daterange:

  type: field.field_settings.datetime

  label: 'Date range settings'

field.value.daterange:

  type: mapping

  label: 'Default value'

  mapping:

    default_date_type:

      type: string

      label: 'Default start date type'

    default_date:

      type: string

      label: 'Default start date value'

    default_end_date_type:

      type: string

      label: 'Default end date type'

    default_end_date:

      type: string

      label: 'Default end date value'

field.formatter.settings.daterange_default:

  type: field.formatter.settings.datetime_default

  label: 'Date range default display format settings'

  mapping:

    separator:

      type: string

      label: 'Separator'

field.formatter.settings.daterange_plain:

  type: field.formatter.settings.datetime_plain

  label: 'Date range plain display format settings'

  mapping:

    separator:

      type: string

      label: 'Separator'

field.formatter.settings.daterange_custom:

  type: field.formatter.settings.datetime_custom

  label: 'Date range custom display format settings'

  mapping:

    separator:

      type: string

      label: 'Separator'

field.widget.settings.daterange_datelist:

  type: mapping

  label: 'Date range select list display format settings'

  mapping:

    increment:

      type: integer

      label: 'Time increments'

    date_order:

      type: string

      label: 'Date part order'

    time_type:

      type: string

      label: 'Time type'

field.widget.settings.daterange_default:

  type: mapping

  label: 'Date range default display format settings'

name: 'Datetime Range'

type: module

description: 'Provides the ability to store end dates.'

package: Core (Experimental)

version: VERSION

core: 8.x

dependencies:

  - datetime

<?php

/**

 * @file

 * Field hooks to implement a datetime field that stores a start and end date.

 */

use Drupal\Core\Routing\RouteMatchInterface;

/**

 * Implements hook_help().

 */

function datetime_range_help($route_name, RouteMatchInterface $route_match) {

  switch ($route_name) {

    case 'help.page.datetime_range':

      $output = '';

      $output .= '<h3>' . t('About') . '</h3>';

      $output .= '<p>' . t('The Datetime Range module provides a Date field that stores start dates and times, as well as end dates and times. See the <a href=":field">Field module help</a> and the <a href=":field_ui">Field UI module help</a> pages for general information on fields and how to create and manage them. For more information, see the <a href=":datetime_do">online documentation for the Datetime Range module</a>.', array(':field' => \Drupal::url('help.page', array('name' => 'field')), ':field_ui' => (\Drupal::moduleHandler()->moduleExists('field_ui')) ? \Drupal::url('help.page', array('name' => 'field_ui')) : '#', ':datetime_do' => 'https://www.drupal.org/documentation/modules/datetime_range')) . '</p>';

      $output .= '<h3>' . t('Uses') . '</h3>';

      $output .= '<dl>';

      $output .= '<dt>' . t('Managing and displaying date fields') . '</dt>';

      $output .= '<dd>' . t('The <em>settings</em> and the <em>display</em> of the Date field can be configured separately. See the <a href=":field_ui">Field UI help</a> for more information on how to manage fields and their display.', array(':field_ui' => (\Drupal::moduleHandler()->moduleExists('field_ui')) ? \Drupal::url('help.page', array('name' => 'field_ui')) : '#')) . '</dd>';

      $output .= '<dt>' . t('Displaying dates') . '</dt>';

      $output .= '<dd>' . t('Dates can be displayed using the <em>Plain</em> or the <em>Default</em> formatter. The <em>Plain</em> formatter displays the date in the <a href="http://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a> format. If you choose the <em>Default</em> formatter, you can choose a format from a predefined list that can be managed on the <a href=":date_format_list">Date and time formats</a> page.', array(':date_format_list' => \Drupal::url('entity.date_format.collection'))) . '</dd>';

      $output .= '</dl>';

      return $output;

  }

}