league/period

Time range API for PHP

5.3.3 2025-10-17 10:15 UTC

Requires

• php: ^8.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.65.0
• phpstan/phpstan: ^1.12.12
• phpstan/phpstan-deprecation-rules: ^1.2.1
• phpstan/phpstan-phpunit: ^1.4.1
• phpstan/phpstan-strict-rules: ^1.6.1
• phpunit/phpunit: ^10.5.15 || ^11.5.0
• symfony/var-dumper: ^6.4.15

MIT

• Ignace Nyamagana Butera

• time
• date
• schedule
• calendar
• timeline
• sequence
• period
• datetime
• collection
• interval
• range
• dateinterval
• dateperiod
• unions
• boundaries
• gap
• intersections

README

Period is PHP's missing time range API. This package covers all basic operations regarding time ranges.

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.

System Requirements

You need PHP >= 8.1.0 but the latest stable version of PHP is recommended.

Install

Install Period using Composer.

$ composer require league/period

or download the library and:

• 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.

Testing

Period has:

• 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.

$ composer test

Contributing

Contributions are welcome and will be fully credited. Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• Ignace Nyamagana Butera
• All Contributors

License

The MIT License (MIT). Please see LICENSE for more information.