PHPackages                             esi/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. [PSR & Standards](/categories/psr-standards)
4. /
5. esi/clock

ActiveLibrary[PSR & Standards](/categories/psr-standards)

esi/clock
=========

Yet another PSR-20 clock implementation

1.1.1(2mo ago)211.1k↓50%[3 PRs](https://github.com/ericsizemore/clock/pulls)1MITPHPPHP >=8.2CI passing

Since Apr 11Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/ericsizemore/clock)[ Packagist](https://packagist.org/packages/esi/clock)[ Fund](https://ko-fi.com/ericsizemore)[ GitHub Sponsors](https://github.com/ericsizemore)[ RSS](/packages/esi-clock/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (14)Versions (9)Used By (1)

Clock
=====

[](#clock)

[![Build Status](https://camo.githubusercontent.com/930d6aa28ed2b184a2e5ebb94fdb51d41718cadea93567ecc9f8523ab822474f/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6572696373697a656d6f72652f636c6f636b2f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ericsizemore/clock/build-status/master)[![Code Coverage](https://camo.githubusercontent.com/566b86d371429bea0f941e2453e543201d7f256de04d1897054b479785fa74a7/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6572696373697a656d6f72652f636c6f636b2f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ericsizemore/clock/?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/1e0e24e0ae6ac87ff41a36ecdc194e912b9b7577b7c33bede5378219a6205f14/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6572696373697a656d6f72652f636c6f636b2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ericsizemore/clock/?branch=master)[![Tests](https://github.com/ericsizemore/clock/actions/workflows/tests.yml/badge.svg)](https://github.com/ericsizemore/clock/actions/workflows/tests.yml)[![PHPStan](https://github.com/ericsizemore/clock/actions/workflows/main.yml/badge.svg)](https://github.com/ericsizemore/clock/actions/workflows/main.yml)[![Psalm Static analysis](https://github.com/ericsizemore/clock/actions/workflows/psalm.yml/badge.svg?branch=master)](https://github.com/ericsizemore/clock/actions/workflows/psalm.yml)[![Type Coverage](https://camo.githubusercontent.com/de687f26dba4345c5928847dfb5ded4e1737eade355c962f1a0d921de989cfec/68747470733a2f2f73686570686572642e6465762f6769746875622f6572696373697a656d6f72652f636c6f636b2f636f7665726167652e737667)](https://shepherd.dev/github/ericsizemore/clock)[![Psalm Level](https://camo.githubusercontent.com/9ec923d039310d994b640d3092b918c43fb74f3f0430b9966839c22b102d63be/68747470733a2f2f73686570686572642e6465762f6769746875622f6572696373697a656d6f72652f636c6f636b2f6c6576656c2e737667)](https://shepherd.dev/github/ericsizemore/clock)[![Latest Stable Version](https://camo.githubusercontent.com/6e81ed57e41b724937c1f42a54d56a3db1eb0746be2a678d0a5e805f0103bc08/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6573692f636c6f636b2e737667)](https://packagist.org/packages/esi/clock)[![Downloads per Month](https://camo.githubusercontent.com/e452bed8e544b6bf5f4351bf257b9d9038c5805c6da09f9cb9d7a2db32cdcf1f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6573692f636c6f636b2e737667)](https://packagist.org/packages/esi/clock)[![License](https://camo.githubusercontent.com/071180f8705fa81e08056d1c7ae356a2cc702833094230e695c164a5f2855b9d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6573692f636c6f636b2e737667)](https://packagist.org/packages/esi/clock)[![Mutation testing badge](https://camo.githubusercontent.com/31abcbf9e294aa5f8b3aeecc3fbe59cc5a2047a2a44895e476f3309ad138a80b/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742675726c3d687474707325334125324625324662616467652d6170692e737472796b65722d6d757461746f722e696f2532466769746875622e636f6d2532466572696373697a656d6f7265253246636c6f636b2532466d6173746572)](https://dashboard.stryker-mutator.io/reports/github.com/ericsizemore/clock/master)[![SymfonyInsight](https://camo.githubusercontent.com/58a22d2e2eb8374e2da3420dacf2a33bd64c185106708bb9102ed0a21cb0e04f/68747470733a2f2f696e73696768742e73796d666f6e792e636f6d2f70726f6a656374732f39383938623632622d376665642d343262652d623334652d3566396365336532386632642f6d696e692e737667)](https://insight.symfony.com/projects/9898b62b-7fed-42be-b34e-5f9ce3e28f2d)

Yet ...another... PSR-20 Clock implementation.

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

[](#installation)

### Composer

[](#composer)

The library can be installed with composer. Add this repository as a dependency to the composer.json file.

```
$ composer require esi/clock:^1.0
```

Usage
-----

[](#usage)

- See [USAGE.md](USAGE.md).

About
-----

[](#about)

### Requirements

[](#requirements)

- PHP >= 8.2

### Credits

[](#credits)

- [Eric Sizemore](https://github.com/ericsizemore)
- [All Contributors](https://github.com/ericsizemore/clock/contributors)

### Contributing

[](#contributing)

See [CONTRIBUTING](./CONTRIBUTING.md).

Bugs and feature requests are tracked on [GitHub](https://github.com/ericsizemore/clock/issues).

### Contributor Covenant Code of Conduct

[](#contributor-covenant-code-of-conduct)

See [CODE\_OF\_CONDUCT.md](./CODE_OF_CONDUCT.md)

### Backward Compatibility Promise

[](#backward-compatibility-promise)

See [backward-compatibility.md](./backward-compatibility.md) for more information on Backwards Compatibility.

### Changelog

[](#changelog)

See the [CHANGELOG](./CHANGELOG.md) for more information on what has changed recently.

### License

[](#license)

See the [LICENSE](./LICENSE) for more information on the license that applies to this project.

### Security

[](#security)

See [SECURITY](./SECURITY.md) for more information on the security disclosure process.

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance87

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 54.4% 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 ~342 days

Total

3

Last Release

83d ago

PHP version history (2 changes)1.0.0PHP ^8.2 <8.5

1.1.1PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/b7181952b087db2a847c6b90d5cc5e53948e66229ad16acf92ccca3e8767cb92?d=identicon)[ericsizemore](/maintainers/ericsizemore)

---

Top Contributors

[![ericsizemore](https://avatars.githubusercontent.com/u/723810?v=4)](https://github.com/ericsizemore "ericsizemore (300 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (251 commits)")

---

Tags

clockclock-implementationclock-interfacepsr-20psr20timeclockpsr20psr-20clock-interfacetime

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[psr/clock

Common interface for reading the clock.

642332.9M343](/packages/psr-clock)[symfony/clock

Decouples applications from the system clock

431168.9M205](/packages/symfony-clock)[beste/clock

A collection of Clock implementations

7423.3M20](/packages/beste-clock)[stella-maris/clock

A pre-release of the proposed PSR-20 Clock-Interface

7947.5M2](/packages/stella-maris-clock)[cakephp/chronos

A simple API extension for DateTime.

1.4k47.7M121](/packages/cakephp-chronos)[nesbot/carbon

An API extension for DateTime that supports 281 different languages.

177661.4M4.8k](/packages/nesbot-carbon)

PHPackages © 2026

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