PHPackages                             orisai/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. orisai/clock

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

orisai/clock
============

Provides current time for runtime and controllable time for testing

1.2.2(1y ago)555.9k↑14.6%16MPL-2.0PHPPHP 7.4 - 8.4CI passing

Since Aug 19Pushed 1y ago2 watchersCompare

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

READMEChangelogDependencies (12)Versions (7)Used By (6)

 [![Orisai](https://github.com/orisai/.github/raw/main/images/repo_title.png?raw=true)](https://github.com/orisai/.github/blob/main/images/repo_title.png?raw=true)
 Clock
============================================================================================================================================================================

[](#clock)

 Provider of current time for runtime and controllable time for testing

 [PSR-20](https://www.php-fig.org/psr/psr-20/) compatible

 📄 Check out our [documentation](docs/README.md).

 💸 If you like Orisai, please [make a donation](https://orisai.dev/sponsor). Thank you!

 [![](https://github.com/orisai/clock/actions/workflows/ci.yaml/badge.svg?branch=v1.x)](https://github.com/orisai/clock/actions?query=workflow:CI+branch:v1.x) [![](https://camo.githubusercontent.com/6f47fdf5b72461c8cea9b356ad06a169e45f0f60c1ab8d04e5419001c97562f0/68747470733a2f2f62616467656e2e6e65742f636f766572616c6c732f632f6769746875622f6f72697361692f636c6f636b2f76312e783f63616368653d333030)](https://coveralls.io/github/orisai/clock?branch=v1.x) [![](https://camo.githubusercontent.com/2ec66a9cb526ea841f26b9c032ac02634c74562590cabf48e6b8f068067acad6/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742675726c3d68747470733a2f2f62616467652d6170692e737472796b65722d6d757461746f722e696f2f6769746875622e636f6d2f6f72697361692f636c6f636b2f76312e78)](https://dashboard.stryker-mutator.io/reports/github.com/orisai/clock/v1.x) [![](https://camo.githubusercontent.com/242d1ba925084e01d1aa14b71bcfa1bfa98f81859a7484a584d0c2fbb55116f1/68747470733a2f2f62616467656e2e6e65742f7061636b61676973742f64742f6f72697361692f636c6f636b3f63616368653d33363030)](https://packagist.org/packages/orisai/clock) [![](https://camo.githubusercontent.com/bb1db391504b68f8855ced874bd25d3913bcf2baa59d4d0049aea6f8d464f34b/68747470733a2f2f62616467656e2e6e65742f7061636b61676973742f762f6f72697361692f636c6f636b3f63616368653d33363030)](https://packagist.org/packages/orisai/clock) [![](https://camo.githubusercontent.com/40b2374865c7727b1568a7b77cc1a8068979ac265d85d659fe73b2d337b458e6/68747470733a2f2f62616467656e2e6e65742f62616467652f6c6963656e73652f4d504c2d322e302f626c75653f63616368653d33363030)](https://choosealicense.com/licenses/mpl-2.0/)

```
use Orisai\Clock\Clock;
use function Orisai\Clock\now;

class ExampleService
{

	private Clock $clock;

	public function __construct(Clock $clock)
	{
		$this->clock = $clock;
	}

	public function doSomething(): void
	{
		$currentTime = $this->clock->now();
		// Or
		$currentTime = now();
	}

}
```

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance40

Moderate activity, may be stable

Popularity36

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity69

Established project with proven stability

 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 ~144 days

Recently: every ~188 days

Total

7

Last Release

505d ago

PHP version history (4 changes)1.0.0PHP >=7.4.0 <8.2.0

1.1.1PHP >=7.4.0 <8.3.0

1.2.1PHP 7.4 - 8.3

1.2.2PHP 7.4 - 8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/20974277?v=4)[Marek Bartoš](/maintainers/mabar)[@mabar](https://github.com/mabar)

---

Top Contributors

[![mabar](https://avatars.githubusercontent.com/u/20974277?v=4)](https://github.com/mabar "mabar (37 commits)")

---

Tags

clockdatedatetimeorisaiphppsrpsr-20symfonytimepsrsymfonyclockpsr-20datetimetimedateorisai

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[psr/clock

Common interface for reading the clock.

642332.9M343](/packages/psr-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)[stella-maris/clock

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

7947.5M2](/packages/stella-maris-clock)[kdyby/datetime-provider

Time provider, providing consistent current date, time, datetime and timezone across the request.

1146.8k1](/packages/kdyby-datetime-provider)

PHPackages © 2026

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