https://github.com/symfony/clock
Decouples applications from the system clock
https://github.com/symfony/clock
clock component php psr20 symfony symfony-component time
Last synced: 9 months ago
JSON representation
Decouples applications from the system clock
- Host: GitHub
- URL: https://github.com/symfony/clock
- Owner: symfony
- License: mit
- Created: 2022-07-28T06:54:55.000Z (over 3 years ago)
- Default Branch: 7.2
- Last Pushed: 2025-04-09T08:22:13.000Z (10 months ago)
- Last Synced: 2025-04-11T00:51:41.845Z (10 months ago)
- Topics: clock, component, php, psr20, symfony, symfony-component, time
- Language: PHP
- Homepage: https://symfony.com/clock
- Size: 67.4 KB
- Stars: 364
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Clock Component
===============
Symfony Clock decouples applications from the system clock.
Getting Started
---------------
```bash
composer require symfony/clock
```
```php
use Symfony\Component\Clock\NativeClock;
use Symfony\Component\Clock\ClockInterface;
class MyClockSensitiveClass
{
public function __construct(
private ClockInterface $clock,
) {
// Only if you need to force a timezone:
//$this->clock = $clock->withTimeZone('UTC');
}
public function doSomething()
{
$now = $this->clock->now();
// [...] do something with $now, which is a \DateTimeImmutable object
$this->clock->sleep(2.5); // Pause execution for 2.5 seconds
}
}
$clock = new NativeClock();
$service = new MyClockSensitiveClass($clock);
$service->doSomething();
```
Resources
---------
* [Documentation](https://symfony.com/doc/current/components/clock.html)
* [Contributing](https://symfony.com/doc/current/contributing/index.html)
* [Report issues](https://github.com/symfony/symfony/issues) and
[send Pull Requests](https://github.com/symfony/symfony/pulls)
in the [main Symfony repository](https://github.com/symfony/symfony)