league/period

A time range immutable value object

Period

, _(*1)

Period is PHP's missing time range API. This package covers all basic operations regarding time ranges., _(*2)

Highlights

• Represents Interval and Bounds as immutable value objects or enumeration
• Exposes named constructors to ease instantiation
• Covers all basic manipulations related to time range
• Enables working with simple or complex time ranges logic
• Fully documented
• Framework-agnostic

Documentation

Full documentation can be found at period.thephpleague.com., _(*3)

System Requirements

You need PHP >= 8.1.0 but the latest stable version of PHP is recommended., _(*4)

Install

Install Period using Composer., _(*5)

$ composer require league/period

or download the library and:, _(*6)

• use any other PSR-4 compatible autoloader.
• use the bundle autoloader script as shown below:

require 'path/to/period/repo/autoload.php';

use League\Period\Datepoint;

Datepoint::fromDateString('2012-05-23')->month()->toIso80000('Y-m-d');
//returns [2012-05-01, 2012-06-01)

where path/to/period/repo represents the path where the library was extracted., _(*7)

Testing

Period has:, _(*8)

• a PHPUnit test suite
• a code analysis compliance test suite using PHPStan.
• a coding style compliance test suite using PHP CS Fixer.

To run the tests, run the following command from the project folder., _(*9)

bash $ composer test, _(*10)

Contributing

Contributions are welcome and will be fully credited. Please see CONTRIBUTING and CONDUCT for details., _(*11)

Security

If you discover any security related issues, please email nyamsprod@gmail.com instead of using the issue tracker., _(*12)

Changelog

Please see CHANGELOG for more information on what has changed recently., _(*13)

Credits

• Ignace Nyamagana Butera
• All Contributors

License

The MIT License (MIT). Please see LICENSE for more information., _(*14)