azuyalabs/yasumi

计算节假日的简单PHP库

资助包维护!
其他

安装: 6,497,799

依赖者: 20

建议者: 0

安全: 0

星标: 1,035

关注者: 19

分支: 152

开放问题: 3

2.7.0 2024-01-07 14:12 UTC

README

Logo

GitHub Release Total Downloads Coding Standard Static analysis Testing Software License

简介

Yasumi(日语中为“假期”的意思)是一个简单的PHP库,可以帮助您从各个国家/地区检索节假日的日期和名称以及其他特殊庆祝活动。它是基于计算和规则的,避免了需要全面数据库的需求。

存在许多可以提供节假日信息的服务,但它们要么不是完全免费的,要么只提供有限的信息。此外,目前还没有涵盖广泛节假日和国家的全面PHP库。《PEAR的Date_Holidays》库是一个类似的尝试,但它已经很久没有更新了。

亮点

Yasumi的目标是在保持轻量级的同时保持强大,尽可能使用PHP原生类。Yasumi的计算基于提供者(即按国家/地区),这使得添加计算假期的新的假日提供者变得容易。

  • 纯PHP
  • 简单的API
  • 框架无关
  • 使用提供者轻松扩展和扩展新的假日
  • 常见假日提供者
  • 考虑节假日正式设立和/或废除的日期/时间
  • 过滤器可轻松选择特定的假日类型(正式、观察、银行、季节性或其他)
  • 全局翻译
  • 支持时区
  • 实现了ArrayIterator以轻松处理提供者的假日
  • 完全文档化
  • 完全单元测试
  • Composer就绪,符合PSR-12PSR-4

文档

Yasumi的文档可在https://www.yasumi.dev上找到。您将找到有关如何安装Yasumi的所有必要信息,以及如何在项目中使用Yasumi的食谱。

博客

请定期查看文档网站上的博客部分,以获取最新更新。通过方便的博客文章格式,让您了解有关新闻、发布等信息。

贡献

鼓励贡献并欢迎;我总是很高兴在GitHub上收到反馈或拉取请求 :) 为错误和新的功能创建Github Issues,并对您感兴趣的问题进行评论。

如果您喜欢我所做的,一杯额外的咖啡将非常感激 :) 您的支持帮助我把更多时间投入到像这样的开源软件项目中。

Buy Me A Coffee

许可

Yasumi是开源软件,根据MIT许可(MIT)许可。有关更多信息,请参阅LICENSE