# Clock

An implementation of the proposed PSR-20 clock-interface

[![Total Downloads](http://poser.pugx.org/stella-maris/clock/downloads)](https://packagist.org/packages/stella-maris/clock)
[![Latest Stable Version](http://poser.pugx.org/stella-maris/clock/v)](https://packagist.org/packages/stella-maris/clock)
[![Latest Unstable Version](http://poser.pugx.org/stella-maris/clock/v/unstable)](https://packagist.org/packages/stella-maris/clock)

[![pipeline status](https://gitlab.com/stella-maris/clock/badges/main/pipeline.svg)](https://gitlab.com/stella-maris/clock/-/commits/main)

## Installation

```bash
composer require stella-maris/clock
```

## Usage

This interface allows one to inject one of the implemntations that provide the 
clock-interface.

```php
use StellaMaris/Clock/CLockInterface;

final class PastChecker
{
    public function __construct(private ClockInterface $clock) {}
    
    public function hasDateTimeAlreadyPassed(DateTimeImmutable $item): bool
    {
        return $item < $this->clock->now();
    }
}
```

## Why

Within the Framework Interoperability Group (FIG) a working group has started in 2021 to
create a ClockInterface. The works on that have been rather fast and already in the mid of 
2021 the interface was more or less finally decided upon. 

### So why this Interface?

Since mid 2021 no further work has been happening on the Working Group. All requests towards
the editor and the sponsor weren't met with any reaction.

So after a lot of discussions on the official working group channel I decided to bring this 
interface forward by providing the currently agreed upon interface as a separate package 
on packagist.

### But what when the PSR Interface is provided?

There are two possibilities: 
* Either the interface will be provided by the FIG as it is currently,
then this interface will extend the PSR-20 one so that all implementations of this 
interface will be immediately PSR20 compatible. 
* Or the PSR20 interface will look different: Then all current implementations will
need to provide a spearate implementation for PSR20 compatibility and this interface will 
simply coexist with the PSR20 one.

## Documentation

For a more thorough information about the interface please check the PSR-20 documentation 
at https://github.com/php-fig/fig-standards/blob/master/proposed/clock.md and 
https://github.com/php-fig/fig-standards/blob/master/proposed/clock-meta.md

• [D] src
• [F] .editorconfig
  Delete
• [F] composer.json
  Delete
• [F] LICENSE.md
  Delete
• [F] README.md
  Delete

Blog Section

Discover the Latest in Digital Payments and NFC Technology

Dive into our blog to explore the cutting-edge trends in digital payments and NFC technology. Stay updated on the innovations that are revolutionizing transactions, boosting security, and making payments quicker and more convenient. Learn how these advancements are shaping the future of financial interactions and driving the global transition towards a cashless world.

The Rise of Contactless Payments:...

In recent years, contactless payments have surged in popularity, driven...

Visit Blog

March 27, 2024

Enhancing Payment Security: The Role...

As digital transactions proliferate, ensuring robust payment security is more critical than ever. Two foundational...

Visit Blog

March 27, 2024

The Future of Digital Wallets:...

Digital wallets have fundamentally transformed how we manage money, offering a streamlined, secure, and highly...

Visit Blog

March 27, 2024