PHPackages                             chrisharrison/clock - 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. [Utility & Helpers](/categories/utility)
4. /
5. chrisharrison/clock

ActiveLibrary[Utility & Helpers](/categories/utility)

chrisharrison/clock
===================

A PHP 7 clock interface.

1.0.0(8y ago)217.1k↑16.7%3MITPHPPHP >=7.1

Since Dec 23Pushed 8y ago1 watchersCompare

[ Source](https://github.com/chrisharrison/clock)[ Packagist](https://packagist.org/packages/chrisharrison/clock)[ RSS](/packages/chrisharrison-clock/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (3)

clock
=====

[](#clock)

A PHP 7 clock interface.

[![Build Status](https://camo.githubusercontent.com/6f363c484938df897543f95350f67bc96796c1d77162a143b5602c4b069174ed/68747470733a2f2f7472617669732d63692e6f72672f63687269736861727269736f6e2f636c6f636b2e737667)](https://travis-ci.org/chrisharrison/clock)[![Version](https://camo.githubusercontent.com/a63b9df62938df3aa62f6a4a49ce0d2ed26006b062d75d838f7eb18da6d38d5c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f63687269736861727269736f6e2f636c6f636b2e737667)](https://packagist.org/packages/chrisharrison/clock)

Installation
------------

[](#installation)

Through Composer, obviously:

```
composer require chrisharrison/clock

```

Examples
--------

[](#examples)

### Frozen clock (useful for testing)

[](#frozen-clock-useful-for-testing)

```
$frozenClock = new \ChrisHarrison\Clock\FrozenClock(new \DateTime('1988-05-01 16:00:00'));
echo $frozenClock->now()->format('Y-m-d H:i:s');
echo $frozenClock->now()->format('Y-m-d H:i:s');
echo $frozenClock->now()->format('Y-m-d H:i:s');
```

Outputs:

```
1988-05-01 16:00:00
1988-05-01 16:00:00
1988-05-01 16:00:00

```

### System clock (has a hard dependency on the underlying operating system's clock)

[](#system-clock-has-a-hard-dependency-on-the-underlying-operating-systems-clock)

```
$systemClock = new \ChrisHarrison\Clock\SystemClock;
echo $systemClock->now()->format('Y-m-d H:i:s');
echo $systemClock->now()->format('Y-m-d H:i:s');
echo $systemClock->now()->format('Y-m-d H:i:s');
```

Outputs:

```
2017-10-01 20:43:22
2017-10-01 20:43:23
2017-10-01 20:43:24

```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity58

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

Unknown

Total

1

Last Release

3068d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/296186?v=4)[Chris Harrison](/maintainers/chrisharrison)[@chrisharrison](https://github.com/chrisharrison)

---

Top Contributors

[![chrisharrison](https://avatars.githubusercontent.com/u/296186?v=4)](https://github.com/chrisharrison "chrisharrison (12 commits)")

---

Tags

clockdependency-injectioniocphpphp7

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/chrisharrison-clock/health.svg)

```
[![Health](https://phpackages.com/badges/chrisharrison-clock/health.svg)](https://phpackages.com/packages/chrisharrison-clock)
```

PHPackages © 2026

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