PHPackages                             bitwise-operators/mockclock - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing & Quality](/categories/testing)
4. /
5. bitwise-operators/mockclock

ActiveLibrary[Testing & Quality](/categories/testing)

bitwise-operators/mockclock
===========================

A simple implementation of psr/clock to be used in unit testing

1.1.0(11mo ago)032BSD-3-ClausePHPPHP >=8.3

Since Aug 25Pushed 11mo agoCompare

[ Source](https://github.com/bitwise-operators/mockclock)[ Packagist](https://packagist.org/packages/bitwise-operators/mockclock)[ RSS](/packages/bitwise-operators-mockclock/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (5)Versions (4)Used By (0)

MockClock
=========

[](#mockclock)

A simple implementation of psr/clock to be used in unit testing.

Usage
-----

[](#usage)

This class is intended to be used when testing classes that use `Psr\Clock\ClockInterface` through dependency injection.

In your unit tests, create an instance of the clock and pass it to the constructor of the class under test. You can then alter the clock as desired, and check if the output of your class matches expectation.

Unless the clock is actively modified, the time on the clock does not change after instantiation. This way, repeated calls to the class under test should be idempotent (as far as time is concerned).

### Example

[](#example)

```
#[\PHPUnit\Framework\Attributes\Test]
public function test_the_clock(
): void {
    $clock = new \BitwiseOperators\MockClock();

    $myClass = new MyClass(clock: $clock);

    $firstValue = $myClass->myMethod();

    $clock->sleep(50);

    $secondValue = $myClass->myMethod();

    self::assertNotEquals($firstValue, $secondValue);
}
```

### Available methods

[](#available-methods)

The following methods are available to on the clock:

#### `now(): DateTimeImmutable`

[](#now-datetimeimmutable)

See

#### `add(DateTimeInterval): static`

[](#adddatetimeinterval-static)

Increments the time on the clock by the specified amount.

#### `modify(string): static`

[](#modifystring-static)

Modifies the clock according to the formats described in the [PHP manual](https://www.php.net/manual/en/datetime.formats.php).

#### `set(DateTimeInterface): static`

[](#setdatetimeinterface-static)

Sets the the clock to the specified date.

#### `setTimezone(DateTimeZone | string): static`

[](#settimezonedatetimezone--string-static)

Set the timezone of the clock to the specified timezone.

Note that a subsequent call to either `set()` or `modify()` may override this.

#### `sleep(float | int): static`

[](#sleepfloat--int-static)

Advances the clock the specified number of seconds

#### `startOfDay(): static`

[](#startofday-static)

Set the time on the clock to "00:00:00". The date is unaffected.

#### `sub(DateTimeInterval): static`

[](#subdatetimeinterval-static)

Turns back the time on the clock by the specified amount.

### Chaining

[](#chaining)

Aside from the `now()` method, all methods return the clock itself, allowing for chaining:

```
$clock = new \BitwiseOperators\MockClock()
    ->set(new \DateTime('1995-06-08'))
    ->startOfDay()
    ->add(new \DateTimeInterval('PT1H'))
    ->setTimezone('Europe/Copenhagen')
;
```

### Extending

[](#extending)

The MockClock is designed to be extendable. Simply create your own Clock class that extends the MockClock and add any extra methods you might need:

```
namespace Tests\Support;

class MyMockClock extends \BitwiseOperators\MockClock {
    public function setToEpoch(): static {
        return $this->set(new \DateTime('1970-01-01T00:00:00'));
    }
}
```

Even if you don't add methods immediately, extending the class and using your own is always a good idea as a form of [dependency inversion](https://en.wikipedia.org/wiki/Dependency_inversion_principle).

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance50

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

358d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/67020940?v=4)[bitwise-operators](/maintainers/bitwise-operators)[@bitwise-operators](https://github.com/bitwise-operators)

---

Top Contributors

[![bitwise-operators](https://avatars.githubusercontent.com/u/67020940?v=4)](https://github.com/bitwise-operators "bitwise-operators (1 commits)")

---

Tags

testingphpunitmockingpsr-clock

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/bitwise-operators-mockclock/health.svg)

```
[![Health](https://phpackages.com/badges/bitwise-operators-mockclock/health.svg)](https://phpackages.com/packages/bitwise-operators-mockclock)
```

###  Alternatives

[phpunit/phpunit

The PHP Unit Testing framework.

20.0k971.0M166.3k](/packages/phpunit-phpunit)[brianium/paratest

Parallel testing for PHP

2.5k142.8M1.1k](/packages/brianium-paratest)[dg/bypass-finals

Removes final keyword from source code on-the-fly and allows mocking of final methods and classes

57530.2M667](/packages/dg-bypass-finals)[spatie/phpunit-snapshot-assertions

Snapshot testing with PHPUnit

69720.4M691](/packages/spatie-phpunit-snapshot-assertions)[yoast/phpunit-polyfills

Set of polyfills for changed PHPUnit functionality to allow for creating PHPUnit cross-version compatible tests

18645.6M1.5k](/packages/yoast-phpunit-polyfills)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)