getwarp/clock

Enhanced DateTime classes and Clock API implementation

3.1.4 2023-05-13 09:01 UTC

Requires

• php: ^7.4|^8.0
• ext-json: *
• psr/clock: ^1.0

Provides

• psr/clock-implementation: ^1.0

MIT

• Constantine Karnaukhov

• time
• date
• datetime
• clock

README

getwarp/clock

Enhanced DateTime classes and Clock API implementation

GitHub • Packagist • Installation • Usage

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

• Constantine Karnaukhov
• All Contributors

License

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