W3cubDocs

/Drupal 8

public function DateFormatterInterface::formatTimeDiffSince

public DateFormatterInterface::formatTimeDiffSince($timestamp, $options = array())

Formats the time difference from a timestamp to the current request time.

Parameters

$timestamp: A UNIX timestamp to compare against the current request time.

array $options: (optional) An associative array with additional options. The following keys can be used:

  • granularity: An integer value that signals how many different units to display in the string. Defaults to 2.
  • langcode: The language code for the language used to format the date. Defaults to NULL, which results in the user interface language for the page being used.
  • strict: A Boolean value indicating whether or not the timestamp can be after the current request time. If TRUE (default) and $timestamp is after the current request time, the result string will be "0 seconds". If FALSE and $timestamp is after the current request time, the result string will be the formatted time difference.
  • return_as_object: A Boolean value whether to return a FormattedDateDiff object.

Return value

string|\Drupal\Core\Datetime\FormattedDateDiff A translated string representation of the difference between the given timestamp and the current request time. This interval is always positive.

See also

\Drupal\Core\Datetime\DateFormatterInterface::formatDiff()

\Drupal\Core\Datetime\DateFormatterInterface::formatTimeDiffUntil()

File

core/lib/Drupal/Core/Datetime/DateFormatterInterface.php, line 145

Class

DateFormatterInterface
Provides an interface defining a date formatter.

Namespace

Drupal\Core\Datetime

Code

public function formatTimeDiffSince($timestamp, $options = array());

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Datetime!DateFormatterInterface.php/function/DateFormatterInterface::formatTimeDiffSince/8.1.x