4.6 common.inc format_interval($timestamp, $granularity = 2)
4.7 common.inc format_interval($timestamp, $granularity = 2)
5 common.inc format_interval($timestamp, $granularity = 2)
6 common.inc format_interval($timestamp, $granularity = 2, $langcode = NULL)
7 common.inc format_interval($interval, $granularity = 2, $langcode = NULL)

Format a time interval with the requested granularity.

Parameters

$timestamp: The length of the interval in seconds.

$granularity: How many different units to display in the string.

Return value

A translated string representation of the interval.

Related topics

10 calls to format_interval()
aggregator_view in modules/aggregator.module
comment_block in modules/comment.module
Implementation of hook_block().
statistics_top_pages in modules/statistics.module
Menu callback; presents the "Top pages" page.
statistics_top_referrers in modules/statistics.module
Menu callback; presents the "Top referrers" page.
statistics_top_users in modules/statistics.module
Menu callback; presents the "Top users" page.

... See full list

6 string references to 'format_interval'

File

includes/common.inc, line 765
Common functions that many Drupal modules will need to reference.

Code

function format_interval($timestamp, $granularity = 2) {
  $units = array('1 year|%count years' => 31536000, '1 week|%count weeks' => 604800, '1 day|%count days' => 86400, '1 hour|%count hours' => 3600, '1 min|%count min' => 60, '1 sec|%count sec' => 1);
  $output = '';
  foreach ($units as $key => $value) {
    $key = explode('|', $key);
    if ($timestamp >= $value) {
      $output .= ($output ? ' ' : '') . format_plural(floor($timestamp / $value), $key[0], $key[1]);
      $timestamp %= $value;
      $granularity--;
    }

    if ($granularity == 0) {
      break;
    }
  }
  return $output ? $output : t('0 sec');
}