Handling date-times in PHP can be done with "relative" ease through usage of the in-built date and date_*
functions, the DateTime and DateTime classes, or even with useful libraries like Carbon.
Dealing with dates and times as separate entities remains awkward. A common solution is to use the date-time objects still and just ignore either the date or time part respectively - however, this then requires better variable naming, additional comments, doesn't give any extra type safety and makes comparisons harder.
This library aims to make dealing with dates and times as separate entities simple by providing 2 slim interfaces which
are very similar to the core DateTimeInterface and 2 simple classes which implement these interfaces and provide
a few convenience methods based on DateTimeImmutable.
The internals of the library lean heavily on DateTimeImmutable to handle formatting etc.
Extenders can either implement the interfaces provided here, or extend the simple classes provided here (within the
classes all references are to static rather than self to allow easily overriding their behaviour).
This library adheres to the PSR12 coding standard. Run the style check by running
./vendor/bin/phpcs --standard="phpcs.xml" src
This library uses Psalm for static analysis. Run the analyzer by running
./vendor/bin/psalm
This library uses PHPUnit for testing. Run the tests by running
./vendor/bin/phpunit tests