class DateFormatter

Same name in other branches
  1. 9 core/lib/Drupal/Core/Datetime/DateFormatter.php \Drupal\Core\Datetime\DateFormatter
  2. 8.9.x core/lib/Drupal/Core/Datetime/DateFormatter.php \Drupal\Core\Datetime\DateFormatter
  3. 10 core/lib/Drupal/Core/Datetime/DateFormatter.php \Drupal\Core\Datetime\DateFormatter

Provides a service to handle various date related functionality.

Hierarchy

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\Datetime
View 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;
    
    /**
     * The available date formats.
     *
     * @var array
     */
    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 The available date formats.
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.