class DateFormatter
Same name in other branches
- 9 core/lib/Drupal/Core/Datetime/DateFormatter.php \Drupal\Core\Datetime\DateFormatter
- 8.9.x core/lib/Drupal/Core/Datetime/DateFormatter.php \Drupal\Core\Datetime\DateFormatter
- 10 core/lib/Drupal/Core/Datetime/DateFormatter.php \Drupal\Core\Datetime\DateFormatter
Provides a service to handle various date related functionality.
Hierarchy
- class \Drupal\Core\Datetime\DateFormatter implements \Drupal\Core\Datetime\DateFormatterInterface uses \Drupal\Core\StringTranslation\StringTranslationTrait
Expanded class hierarchy of DateFormatter
Related topics
1 file declares its use of DateFormatter
- DateTest.php in core/
tests/ Drupal/ Tests/ Core/ Datetime/ DateTest.php
File
-
core/
lib/ Drupal/ Core/ Datetime/ DateFormatter.php, line 18
Namespace
Drupal\Core\DatetimeView source
class DateFormatter implements DateFormatterInterface {
use StringTranslationTrait;
/**
* The list of loaded timezones.
*
* @var array
*/
protected $timezones;
/**
* The date format storage.
*
* @var \Drupal\Core\Entity\EntityStorageInterface
*/
protected $dateFormatStorage;
/**
* Language manager for retrieving the default langcode when none is specified.
*
* @var \Drupal\Core\Language\LanguageManagerInterface
*/
protected $languageManager;
/**
* The configuration factory.
*
* @var \Drupal\Core\Config\ConfigFactoryInterface
*/
protected $configFactory;
/**
* The request stack.
*
* @var \Symfony\Component\HttpFoundation\RequestStack
*/
protected $requestStack;
protected $dateFormats = [];
/**
* Contains the different date interval units.
*
* This array is keyed by strings representing the unit (e.g.
* '@count year|@count years') and with the amount of values of the unit in
* seconds.
*
* @var array
*/
protected $units = [
'@count year|@count years' => 31536000,
'@count month|@count months' => 2592000,
'@count week|@count weeks' => 604800,
'@count day|@count days' => 86400,
'@count hour|@count hours' => 3600,
'@count min|@count min' => 60,
'@count sec|@count sec' => 1,
];
/**
* Constructs a Date object.
*
* @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
* The entity type manager service.
* @param \Drupal\Core\Language\LanguageManagerInterface $language_manager
* The language manager.
* @param \Drupal\Core\StringTranslation\TranslationInterface $translation
* The string translation.
* @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
* The configuration factory.
* @param \Symfony\Component\HttpFoundation\RequestStack $request_stack
* The request stack.
*/
public function __construct(EntityTypeManagerInterface $entity_type_manager, LanguageManagerInterface $language_manager, TranslationInterface $translation, ConfigFactoryInterface $config_factory, RequestStack $request_stack) {
$this->dateFormatStorage = $entity_type_manager->getStorage('date_format');
$this->languageManager = $language_manager;
$this->stringTranslation = $translation;
$this->configFactory = $config_factory;
$this->requestStack = $request_stack;
}
/**
* {@inheritdoc}
*/
public function format($timestamp, $type = 'medium', $format = '', $timezone = NULL, $langcode = NULL) {
if (!isset($timezone)) {
$timezone = date_default_timezone_get();
}
// Store DateTimeZone objects in an array rather than repeatedly
// constructing identical objects over the life of a request.
if (!isset($this->timezones[$timezone])) {
$this->timezones[$timezone] = timezone_open($timezone);
}
if (empty($langcode)) {
$langcode = $this->languageManager
->getCurrentLanguage()
->getId();
}
// Create a DrupalDateTime object from the timestamp and timezone.
$create_settings = [
'langcode' => $langcode,
];
$date = DrupalDateTime::createFromTimestamp($timestamp, $this->timezones[$timezone], $create_settings);
// If we have a non-custom date format use the provided date format pattern.
if ($type !== 'custom') {
if ($date_format = $this->dateFormat($type, $langcode)) {
$format = $date_format->getPattern();
}
}
// Fall back to the 'fallback' date format type if the format string is
// empty, either from not finding a requested date format or being given an
// empty custom format string.
if (empty($format)) {
$format = $this->dateFormat('fallback', $langcode)
->getPattern();
}
// Call $date->format().
$settings = [
'langcode' => $langcode,
];
return $date->format($format, $settings);
}
/**
* {@inheritdoc}
*/
public function formatInterval($interval, $granularity = 2, $langcode = NULL) {
$output = '';
foreach ($this->units as $key => $value) {
$key = explode('|', $key);
if ($interval >= $value) {
$output .= ($output ? ' ' : '') . $this->formatPlural(floor($interval / $value), $key[0], $key[1], [], [
'langcode' => $langcode,
]);
$interval %= $value;
$granularity--;
}
elseif ($output) {
// Break if there was previous output but not any output at this level,
// to avoid skipping levels and getting output like "@count year @count
// second".
break;
}
if ($granularity == 0) {
break;
}
}
return $output ? $output : $this->t('0 sec', [], [
'langcode' => $langcode,
]);
}
/**
* {@inheritdoc}
*/
public function getSampleDateFormats($langcode = NULL, $timestamp = NULL, $timezone = NULL) {
$timestamp = $timestamp ?: time();
// All date format characters for the PHP date() function.
// cspell:disable-next-line
$date_chars = str_split('dDjlNSwzWFmMntLoYyaABgGhHisueIOPTZcrU');
$date_elements = array_combine($date_chars, $date_chars);
return array_map(function ($character) use ($timestamp, $timezone, $langcode) {
return $this->format($timestamp, 'custom', $character, $timezone, $langcode);
}, $date_elements);
}
/**
* {@inheritdoc}
*/
public function formatTimeDiffUntil($timestamp, $options = []) {
$request_time = $this->requestStack
->getCurrentRequest()->server
->get('REQUEST_TIME');
return $this->formatDiff($request_time, $timestamp, $options);
}
/**
* {@inheritdoc}
*/
public function formatTimeDiffSince($timestamp, $options = []) {
$request_time = $this->requestStack
->getCurrentRequest()->server
->get('REQUEST_TIME');
return $this->formatDiff($timestamp, $request_time, $options);
}
/**
* {@inheritdoc}
*/
public function formatDiff($from, $to, $options = []) {
$options += [
'granularity' => 2,
'langcode' => NULL,
'strict' => TRUE,
'return_as_object' => FALSE,
];
if ($options['strict'] && $from > $to) {
$string = $this->t('0 seconds');
if ($options['return_as_object']) {
return new FormattedDateDiff($string, 0);
}
return $string;
}
$date_time_from = new \DateTime();
$date_time_from->setTimestamp($from);
$date_time_to = new \DateTime();
$date_time_to->setTimestamp($to);
$interval = $date_time_to->diff($date_time_from);
$granularity = $options['granularity'];
$output = '';
// We loop over the keys provided by \DateInterval explicitly. Since we
// don't take the "invert" property into account, the resulting output value
// will always be positive.
$max_age = 1.0E+99;
foreach ([
'y',
'm',
'd',
'h',
'i',
's',
] as $value) {
if ($interval->{$value} > 0) {
// Switch over the keys to call formatPlural() explicitly with literal
// strings for all different possibilities.
switch ($value) {
case 'y':
$interval_output = $this->formatPlural($interval->y, '@count year', '@count years', [], [
'langcode' => $options['langcode'],
]);
$max_age = min($max_age, 365 * 86400);
break;
case 'm':
$interval_output = $this->formatPlural($interval->m, '@count month', '@count months', [], [
'langcode' => $options['langcode'],
]);
$max_age = min($max_age, 30 * 86400);
break;
case 'd':
// \DateInterval doesn't support weeks, so we need to calculate them
// ourselves.
$interval_output = '';
$days = $interval->d;
$weeks = floor($days / 7);
if ($weeks) {
$interval_output .= $this->formatPlural($weeks, '@count week', '@count weeks', [], [
'langcode' => $options['langcode'],
]);
$days -= $weeks * 7;
$granularity--;
$max_age = min($max_age, 7 * 86400);
}
if ((!$output || $weeks > 0) && $granularity > 0 && $days > 0) {
$interval_output .= ($interval_output ? ' ' : '') . $this->formatPlural($days, '@count day', '@count days', [], [
'langcode' => $options['langcode'],
]);
$max_age = min($max_age, 86400);
}
else {
// If we did not output days, set the granularity to 0 so that we
// will not output hours and get things like "@count week @count hour".
$granularity = 0;
}
break;
case 'h':
$interval_output = $this->formatPlural($interval->h, '@count hour', '@count hours', [], [
'langcode' => $options['langcode'],
]);
$max_age = min($max_age, 3600);
break;
case 'i':
$interval_output = $this->formatPlural($interval->i, '@count minute', '@count minutes', [], [
'langcode' => $options['langcode'],
]);
$max_age = min($max_age, 60);
break;
case 's':
$interval_output = $this->formatPlural($interval->s, '@count second', '@count seconds', [], [
'langcode' => $options['langcode'],
]);
$max_age = min($max_age, 1);
break;
}
$output .= ($output && $interval_output ? ' ' : '') . $interval_output;
$granularity--;
}
elseif ($output) {
// Break if there was previous output but not any output at this level,
// to avoid skipping levels and getting output like "@count year @count second".
break;
}
if ($granularity <= 0) {
break;
}
}
if (empty($output)) {
$output = $this->t('0 seconds');
$max_age = 0;
}
if ($options['return_as_object']) {
return new FormattedDateDiff($output, $max_age);
}
return $output;
}
/**
* Loads the given format pattern for the given langcode.
*
* @param string $type
* The machine name of the date format type which is one of:
* - One of the built-in date format types: 'short', 'medium',
* 'long', 'html_datetime', 'html_date', 'html_time',
* 'html_yearless_date', 'html_week', 'html_month', 'html_year'.
* - The name of a date format type defined by a date format config entity.
* - The machine name of an administrator-defined date format type.
* - 'custom' for a custom date format type.
* @param string $langcode
* The langcode of the language to use.
*
* @return \Drupal\Core\Datetime\DateFormatInterface|null
* The configuration entity for the date format in the given language for
* non-custom formats, NULL otherwise.
*/
protected function dateFormat($type, $langcode) {
if (!isset($this->dateFormats[$type][$langcode])) {
$original_language = $this->languageManager
->getConfigOverrideLanguage();
$this->languageManager
->setConfigOverrideLanguage(new Language([
'id' => $langcode,
]));
$this->dateFormats[$type][$langcode] = $this->dateFormatStorage
->load($type);
$this->languageManager
->setConfigOverrideLanguage($original_language);
}
return $this->dateFormats[$type][$langcode];
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|
DateFormatter::$configFactory | protected | property | The configuration factory. | ||
DateFormatter::$dateFormats | protected | property | |||
DateFormatter::$dateFormatStorage | protected | property | The date format storage. | ||
DateFormatter::$languageManager | protected | property | Language manager for retrieving the default langcode when none is specified. | ||
DateFormatter::$requestStack | protected | property | The request stack. | ||
DateFormatter::$timezones | protected | property | The list of loaded timezones. | ||
DateFormatter::$units | protected | property | Contains the different date interval units. | ||
DateFormatter::dateFormat | protected | function | Loads the given format pattern for the given langcode. | ||
DateFormatter::format | public | function | Formats a date, using a date type or a custom date format string. | Overrides DateFormatterInterface::format | |
DateFormatter::formatDiff | public | function | Formats a time interval between two timestamps. | Overrides DateFormatterInterface::formatDiff | |
DateFormatter::formatInterval | public | function | Formats a time interval with the requested granularity. | Overrides DateFormatterInterface::formatInterval | |
DateFormatter::formatTimeDiffSince | public | function | Formats the time difference from a timestamp to the current request time. | Overrides DateFormatterInterface::formatTimeDiffSince | |
DateFormatter::formatTimeDiffUntil | public | function | Formats the time difference from the current request time to a timestamp. | Overrides DateFormatterInterface::formatTimeDiffUntil | |
DateFormatter::getSampleDateFormats | public | function | Provides values for all date formatting characters for a given timestamp. | Overrides DateFormatterInterface::getSampleDateFormats | |
DateFormatter::__construct | public | function | Constructs a Date object. | ||
StringTranslationTrait::$stringTranslation | protected | property | The string translation service. | 3 | |
StringTranslationTrait::formatPlural | protected | function | Formats a string containing a count of items. | ||
StringTranslationTrait::getNumberOfPlurals | protected | function | Returns the number of plurals supported by a given language. | ||
StringTranslationTrait::getStringTranslation | protected | function | Gets the string translation service. | ||
StringTranslationTrait::setStringTranslation | public | function | Sets the string translation service to use. | 2 | |
StringTranslationTrait::t | protected | function | Translates a string to the current language or to a given language. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.