function template_preprocess_time

Same name in other branches
  1. 9 core/includes/theme.inc \template_preprocess_time()
  2. 8.9.x core/includes/theme.inc \template_preprocess_time()
  3. 10 core/includes/theme.inc \template_preprocess_time()

Prepares variables for time templates.

Default template: time.html.twig.

Parameters

array $variables: An associative array possibly containing:

  • attributes['timestamp']:
  • timestamp:
  • text:

File

core/includes/theme.inc, line 336

Code

function template_preprocess_time(&$variables) {
    
    /** @var \Drupal\Core\Datetime\DateFormatterInterface $date_formatter */
    $date_formatter = \Drupal::service('date.formatter');
    // Format the 'datetime' attribute based on the timestamp.
    // @see https://www.w3.org/TR/html5-author/the-time-element.html#attr-time-datetime
    if (!isset($variables['attributes']['datetime']) && isset($variables['timestamp'])) {
        $variables['attributes']['datetime'] = $date_formatter->format($variables['timestamp'], 'html_datetime', '', 'UTC');
    }
    // If no text was provided, try to auto-generate it.
    if (!isset($variables['text'])) {
        // Format and use a human-readable version of the timestamp, if any.
        if (isset($variables['timestamp'])) {
            $variables['text'] = $date_formatter->format($variables['timestamp']);
        }
        elseif (isset($variables['attributes']['datetime'])) {
            $variables['text'] = $variables['attributes']['datetime'];
        }
    }
}

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