joomla/datetime

Joomla DateTime Package

The DateTime Package

, _(*1)

, _(*2)

This is a DateTime package built for the Joomla! Framework during Google Summer of Code 2014. The main goal for this library was to create a DateTime object as an Immutable Value Object., _(*3)

Immutability

If you know how to use PHP DateTime object then you know almost everything about that package. Before you start using it you need to know one more thing - this DateTime is immutable. To explain what immutability means let's take a look at an example:, _(*4)

$start = new DateTime('2014-08-24');
$end = $start->addDays(2);

echo $start->format('Y-m-d');  // 2014-08-24
echo $end->format('Y-m-d');    // 2014-08-26

Every method of DateTime is returning a new object and is not changing the current one. That's the most important thing what you have to know., _(*5)

Usage

• Date & DateTime
• DateRange & DateTimeRange
• DateInterval
• GetterInterface
• ParserInterface
• SinceInterface
• AbstractTranslator
• StrategyInterface

Credits

Jens Segers for their approach to translations, _(*6)

Installation via Composer

Add "joomla/datetime": "~2.0" to the require block in your composer.json and then run composer install., _(*7)

{
    "require": {
        "joomla/datetime": "~2.0"
    }
}

Alternatively, you can simply run the following from the command line:, _(*8)

composer require joomla/date "~2.0"