ghostwriter/clock

Provides a Clock implementation for PHP

3.0.2 2026-05-27 07:46 UTC

Requires

• php: ~8.4.0 || ~8.5.0
• ext-mbstring: *
• psr/clock: ^1.0.0

Requires (Dev)

• ext-xdebug: *
• boundwize/structarmed: ^0.7.12
• ghostwriter/coding-standard: dev-main
• ghostwriter/container: ^7.0.2
• ghostwriter/testify: ^0.1.1
• mockery/mockery: ^1.6.12
• phpunit/phpunit: ^13.1.12
• symfony/var-dumper: ^8.0.8

BSD-3-Clause

• Nathanael Esayeas

• clock
• ghostwriter

README

Provides an immutable Clock implementation for PHP

Installation

You can install the package via composer:

composer require ghostwriter/clock

Star ⭐️ this repo if you find it useful

You can also star (🌟) this repo to find it easier later.

Usage

<?php

// Internally uses SystemClock::new(new DateTimeZone(date_default_timezone_get()));

date_default_timezone_set('America/Los_Angeles');
$systemClock = SystemClock::new();
$systemClock->now(); // DateTimeImmutable
$systemClock->now()->getTimezone()->getName(); // America/Los_Angeles

date_default_timezone_set('America/New_York');
$systemClock = SystemClock::new();
$systemClock->now(); // DateTimeImmutable
$systemClock->now()->getTimezone()->getName(); // America/New_York

$localizedClock = LocalizedClock::new();
$localizedClock->now(); // DateTimeImmutable
$localizedClock->now()->getTimezone()->getName(); // UTC

$localizedClock = LocalizedClock::new(new DateTimeZone('Africa/Addis_Ababa'));
$localizedClock->now(); // DateTimeImmutable
$localizedClock->now()->getTimezone()->getName(); // Africa/Addis_Ababa

$frozenClock = FrozenClock::new(new DateTimeImmutable('now', new DateTimeZone('UTC')));
$frozenClock->now(); // DateTimeImmutable
$frozenClock->now()->getTimezone()->getName(); // UTC

API

interface ClockInterface
{
    public function freeze(): FrozenClockInterface;

    public function now(): DateTimeImmutable;
}

interface FrozenClockInterface extends ClockInterface
{
    public static function new(DateTimeImmutable $dateTimeImmutable): self;
}

interface LocalizedClockInterface extends ClockInterface
{
    public static function new(DateTimeZone $dateTimeZone): self;
}

interface SystemClockInterface extends ClockInterface
{
    public static function new(): self;
}

Changelog

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

Security

If you discover any security related issues, please email [e-mail] or create a Security Advisory instead of using the issue tracker.

License

The BSD-3-Clause. Please see License File for more information.