bakame/period

此包已被废弃且不再维护。作者建议使用 league/period 包。

PHP 时间范围 API


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