league/period

PHP 时间范围 API

资助包维护!
nyamsprod

安装量: 3,601,132

依赖者: 24

建议者: 1

安全: 0

星标: 718

关注者: 19

分支: 45

开放问题: 0


README

Author Latest Version Software License Build Total Downloads

Period 是 PHP 中缺失的时间范围 API。此包涵盖了所有关于时间范围的基本操作。

亮点

  • 将区间和界限表示为不可变值对象或枚举
  • 公开命名构造函数以简化实例化
  • 涵盖所有与时间范围相关的基本操作
  • 使处理简单或复杂的时间范围逻辑成为可能
  • 全面文档化
  • 框架无关

文档

完整文档可在 period.thephpleague.com 找到。

系统要求

您需要 PHP >= 8.1.0,但建议使用 PHP 的最新稳定版本。

安装

使用 Composer 安装 Period

$ composer require league/period

或下载库并

  • 使用任何其他 PSR-4 兼容的自动加载器。
  • 使用如下所示的捆绑自动加载脚本
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)

其中 path/to/period/repo 表示库被提取的路径。

测试

Period

  • 一个 PHPUnit 测试套件
  • 一个使用 PHPStan 的代码分析合规性测试套件。
  • 一个使用 PHP CS Fixer 的编码风格合规性测试套件。

要运行测试,请在项目文件夹中运行以下命令。

$ composer test

贡献

欢迎贡献,并将得到充分认可。请参阅 CONTRIBUTINGCONDUCT 了解详情。

安全

如果您发现任何安全相关的问题,请通过电子邮件 nyamsprod@gmail.com 反馈,而不是使用问题跟踪器。

更新日志

有关最近更改的更多信息,请参阅 CHANGELOG

鸣谢

许可

MIT 许可证 (MIT)。有关更多信息,请参阅 LICENSE