henzeb / datetime
Simple testable DateTime instances
Requires
- php: ^7.4|^8.0
Requires (Dev)
- phpstan/phpstan: ^1.4
- phpunit/phpunit: ^9.0
This package is auto-updated.
Last update: 2024-10-11 16:03:22 UTC
README
This package is useful when creating a library or functionality that requires speed over functionality, but still being useful for testing needs.
Don't get me wrong, Carbon is a great package when it comes to modifying DateTime objects, I use it all the time.
But it comes with a price. When you need a lot of its powers, you will see the overhead grow. Faster than using vanilla
DateTime
.
If you don't want your library to be the bottleneck of someone else their code, but still want to be able to test with the ability of changing dates or times, you can use this package.
Installation
Just install with the following command.
composer require henzeb/datetime
Usage
use Henzeb\DateTime\DateTime; DateTime::now(); DateTime::now(new DateTimeZone(...)); DateTime::new('2022-04-25');
Immutable DateTime
use Henzeb\DateTime\DateTimeImmutable; DateTimeImmutable::now(); DateTimeImmutable::now(new DateTimeZone(...)); DateTimeImmutable::new('2022-04-25');
Note: there is no convenient methods or functionality other than new
and now
, It's just vanilla DateTime
or DateTimeImmutable
with timetravel
capabilities.
Unit testing
Just like Carbon, this library has a static setTestNow
method. You can pass a string or a DateTime object.
When passing null
, new DateTime objects will use current date/time again.
use Henzeb\DateTime\DateTime; DateTime::setTestNow('now'); // freezes time DateTime::setTestNow('1999-01-01'); DateTime::setTestNow(new DateTime('1999-01-01'));
Testing
composer test
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email henzeberkheij@gmail.com instead of using the issue tracker.
Credits
License
The GNU AGPLv. Please see License File for more information.