class FormattedDateDiff

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

Contains a formatted time difference.

Hierarchy

Expanded class hierarchy of FormattedDateDiff

1 file declares its use of FormattedDateDiff
DateTest.php in core/tests/Drupal/Tests/Core/Datetime/DateTest.php

File

core/lib/Drupal/Core/Datetime/FormattedDateDiff.php, line 12

Namespace

Drupal\Core\Datetime
View source
class FormattedDateDiff implements RenderableInterface, CacheableDependencyInterface {
    use UnchangingCacheableDependencyTrait;
    
    /**
     * The actual formatted time difference.
     *
     * @var string
     */
    protected $string;
    
    /**
     * The maximum time in seconds that this string may be cached.
     *
     * Let's say the time difference is 1 day 1 hour. In this case, we can cache
     * it until now + 1 hour, so maxAge is 3600 seconds.
     *
     * @var int
     */
    protected $maxAge;
    
    /**
     * Creates a new FormattedDateDiff instance.
     *
     * @param string $string
     *   The formatted time difference.
     * @param int $max_age
     *   The maximum time in seconds that this string may be cached.
     */
    public function __construct($string, $max_age) {
        $this->string = $string;
        $this->maxAge = $max_age;
    }
    
    /**
     * @return string
     */
    public function getString() {
        return $this->string;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getCacheMaxAge() {
        return $this->maxAge;
    }
    
    /**
     * {@inheritdoc}
     */
    public function toRenderable() {
        return [
            '#markup' => $this->string,
            '#cache' => [
                'max-age' => $this->maxAge,
            ],
        ];
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
FormattedDateDiff::$maxAge protected property The maximum time in seconds that this string may be cached.
FormattedDateDiff::$string protected property The actual formatted time difference.
FormattedDateDiff::getCacheMaxAge public function The maximum age for which this object may be cached. Overrides UnchangingCacheableDependencyTrait::getCacheMaxAge
FormattedDateDiff::getString public function
FormattedDateDiff::toRenderable public function Returns a render array representation of the object. Overrides RenderableInterface::toRenderable
FormattedDateDiff::__construct public function Creates a new FormattedDateDiff instance.
UnchangingCacheableDependencyTrait::getCacheContexts public function 1
UnchangingCacheableDependencyTrait::getCacheTags public function 1

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.