You are here

theme.inc in Date 8

Theme files for Date API.

File

date_api/theme/theme.inc
View source
<?php

/**
 * @file
 * Theme files for Date API.
 */
use Drupal\Core\Template\Attribute;
use Drupal\Core\Datetime\DrupalDateTime;

/**
 * Returns HTML for a date timezone element.
 */
function theme_date_timezone($variables) {
  $element = $variables['element'];
  $attributes = $element['#attributes'];
  $wrapper_attributes = array();

  // Add a wrapper to mimic the way a single value field works, for ease in
  // using #states.
  if (isset($element['#children'])) {
    $element['#children'] = '<div id="' . $element['#id'] . '" ' . new Attribute($wrapper_attributes) . '>' . $element['#children'] . '</div>';
  }
  return '<div ' . new Attribute($attributes) . '>' . theme('form_element', $element) . '</div>';
}

/**
 * Returns HTML for a date select element.
 */
function theme_date_select($variables) {
  $element = $variables['element'];
  $attributes = !empty($element['#wrapper_attributes']) ? $element['#wrapper_attributes'] : array(
    'class' => array(),
  );
  $attributes['class'][] = 'container-inline-date';
  $wrapper_attributes = array(
    'class' => array(
      'date-padding',
    ),
  );
  $wrapper_attributes['class'][] = 'clearfix';

  // Add a wrapper to mimic the way a single value field works, for ease in
  // using #states.
  if (isset($element['#children'])) {
    $element['#children'] = '<div id="' . $element['#id'] . '" ' . new Attribute($wrapper_attributes) . '>' . $element['#children'] . '</div>';
  }
  return '<div ' . new Attribute($attributes) . '>' . theme('form_element', $element) . '</div>';
}

/**
 * Returns HTML for a date select input form element.
 */
function theme_date_select_element($variables) {
  $element = $variables['element'];
  $parents = $element['#parents'];
  $part = array_pop($parents);
  return '<div class="date-' . $part . '">' . theme('select', $element) . '</div>';
}

/**
 * Returns HTML for a date block that looks like a mini calendar day.
 *
 * Pass in a date object already set to the right timezone, format as a calendar
 * page date. The calendar styling is created in CSS.
 */
function theme_date_calendar_day($variables) {
  $output = '';
  $date = $variables['date'];
  if (!empty($date)) {
    $output .= '<div class="date-calendar-day">';
    $output .= '<span class="month">' . $date
      ->format('M') . '</span>';
    $output .= '<span class="day">' . $date
      ->format('j') . '</span>';
    $output .= '<span class="year">' . $date
      ->format('Y') . '</span>';
    $output .= '</div>';
  }
  return $output;
}

/**
 * Returns HTML for a date in the format 'time ago'.
 */
function theme_date_time_ago($variables) {
  $start_date = $variables['start_date'];
  $end_date = $variables['end_date'];
  $interval = !empty($variables['interval']) ? $variables['interval'] : 2;
  $display = isset($variables['interval_display']) ? $variables['interval_display'] : 'time ago';

  // If no date is sent, then return nothing.
  if (empty($start_date) || empty($end_date)) {
    return;
  }

  // Time to compare dates to.
  $now = date_format(new DrupalDateTime(), DATE_FORMAT_UNIX);
  $start = date_format($start_date, DATE_FORMAT_UNIX);

  // will be positive for a datetime in the past (ago), and negative for a datetime in the future (hence)
  $time_diff = $now - $start;

  // Uses the same options used by Views format_interval.
  switch ($display) {
    case 'raw time ago':
      return format_interval($time_diff, $interval);
    case 'time ago':
      return t('%time ago', array(
        '%time' => format_interval($time_diff, $interval),
      ));
    case 'raw time hence':
      return format_interval(-$time_diff, $interval);
    case 'time hence':
      return t('%time hence', array(
        '%time' => format_interval(-$time_diff, $interval),
      ));
    case 'raw time span':
      return ($time_diff < 0 ? '-' : '') . format_interval(abs($time_diff), $interval);
    case 'inverse time span':
      return ($time_diff > 0 ? '-' : '') . format_interval(abs($time_diff), $interval);
    case 'time span':
      return t($time_diff < 0 ? '%time hence' : '%time ago', array(
        '%time' => format_interval(abs($time_diff), $interval),
      ));
  }
}

Functions

Namesort descending Description
theme_date_calendar_day Returns HTML for a date block that looks like a mini calendar day.
theme_date_select Returns HTML for a date select element.
theme_date_select_element Returns HTML for a date select input form element.
theme_date_timezone Returns HTML for a date timezone element.
theme_date_time_ago Returns HTML for a date in the format 'time ago'.