getwarp/clock

Enhanced DateTime classes and Clock API implementation

Fund package maintenance!
getwarp
hustlahusky

3.1.4 2023-05-13 09:01 UTC

This package is auto-updated.

Last update: 2024-03-13 11:05:41 UTC


README

Enhanced DateTime classes and Clock API implementation

GitHubPackagistInstallationUsage

Installation

Via Composer

composer require getwarp/clock

Usage

DateTime:

use Warp\Clock\DateTimeImmutableValue;

$time = DateTimeImmutableValue::now();
// $time = DateTimeImmutableValue::from('2020-02-02 20:22:02');
// $time = DateTimeImmutableValue::from(3 * DateTimeImmutableValue::HOUR); // now + 3 hours

\assert($time instanceof \DateTimeImmutable);

echo (string)$time;
// 2020-02-02 20:22:02
echo \json_encode($time);
// 2020-02-02T20:22:02+00:00

Clock:

use Warp\Clock\FrozenClock;
use Warp\Clock\SystemClock;

$clock = new FrozenClock(SystemClock::fromUTC());
$startedAt = $clock->now();
\sleep(5);
$finishedAt = $clock->now();
\assert($startedAt === $finishedAt);

$clock->reset();

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Report issues and send pull requests in the main Warp repository. Please see contributing guide and code of conduct for details.

Credits

License

The MIT License (MIT). Please see license file for more information.