function theme_datetime

Returns HTML for a date / time.

Parameters

$variables: An associative array containing:

  • timestamp: (optional) A UNIX timestamp for the datetime attribute. If the datetime cannot be represented as a UNIX timestamp, use a valid datetime attribute value in $variables['attributes']['datetime'].
  • text: (optional) The content to display within the <time> element. Set 'html' to TRUE if this value is already sanitized for output in HTML. Defaults to a human-readable representation of the timestamp value or the datetime attribute value using format_date(). When invoked as #theme or #theme_wrappers of a render element, the rendered #children are autoamtically taken over as 'text', unless #text is explicitly set.
  • attributes: (optional) An associative array of HTML attributes to apply to the <time> element. A datetime attribute in 'attributes' overrides the 'timestamp'. To create a valid datetime attribute value from a UNIX timestamp, use format_date() with one of the predefined 'html_*' formats.
  • html: (optional) Whether 'text' is HTML markup (TRUE) or plain-text (FALSE). Defaults to FALSE. For example, to use a SPAN tag within the TIME element, this must be set to TRUE, or the SPAN tag will be escaped. It is the responsibility of the caller to properly sanitize the value contained in 'text' (or within the SPAN tag in aforementioned example).

See also

template_preprocess_datetime()

http://www.w3.org/TR/html5-author/the-time-element.html#attr-time-datetime

Related topics

1 theme call to theme_datetime()
template_preprocess_aggregator_summary_item in drupal/core/modules/aggregator/aggregator.pages.inc
Processes variables for aggregator-summary-item.tpl.php.

File

drupal/core/includes/theme.inc, line 1581
The theme system, which controls the output of Drupal.

Code

function theme_datetime($variables) {
  $output = '<time' . new Attribute($variables['attributes']) . '>';
  $output .= !empty($variables['html']) ? $variables['text'] : check_plain($variables['text']);
  $output .= '</time>';
  return $output;
}