azuyalabs / yasumi
计算节假日的简单PHP库
2.7.0
2024-01-07 14:12 UTC
Requires
- php: >=8.0
- ext-json: *
Requires (Dev)
- ext-intl: *
- friendsofphp/php-cs-fixer: ^2.19 || ^3.40
- mikey179/vfsstream: ^1.6
- phan/phan: ^5.4
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^8.5 || ^9.6
- vimeo/psalm: ^5.16
Suggests
- ext-calendar: For calculating the date of Easter
README
简介
Yasumi(日语中为“假期”的意思)是一个简单的PHP库,可以帮助您从各个国家/地区检索节假日的日期和名称以及其他特殊庆祝活动。它是基于计算和规则的,避免了需要全面数据库的需求。
存在许多可以提供节假日信息的服务,但它们要么不是完全免费的,要么只提供有限的信息。此外,目前还没有涵盖广泛节假日和国家的全面PHP库。《PEAR的Date_Holidays》库是一个类似的尝试,但它已经很久没有更新了。
亮点
Yasumi的目标是在保持轻量级的同时保持强大,尽可能使用PHP原生类。Yasumi的计算基于提供者(即按国家/地区),这使得添加计算假期的新的假日提供者变得容易。
- 纯PHP
- 简单的API
- 框架无关
- 使用提供者轻松扩展和扩展新的假日
- 常见假日提供者
- 考虑节假日正式设立和/或废除的日期/时间
- 过滤器可轻松选择特定的假日类型(正式、观察、银行、季节性或其他)
- 全局翻译
- 支持时区
- 实现了ArrayIterator以轻松处理提供者的假日
- 完全文档化
- 完全单元测试
- Composer就绪,符合PSR-12和PSR-4
文档
Yasumi的文档可在https://www.yasumi.dev上找到。您将找到有关如何安装Yasumi的所有必要信息,以及如何在项目中使用Yasumi的食谱。
博客
请定期查看文档网站上的博客部分,以获取最新更新。通过方便的博客文章格式,让您了解有关新闻、发布等信息。
贡献
鼓励贡献并欢迎;我总是很高兴在GitHub上收到反馈或拉取请求 :) 为错误和新的功能创建Github Issues,并对您感兴趣的问题进行评论。
如果您喜欢我所做的,一杯额外的咖啡将非常感激 :) 您的支持帮助我把更多时间投入到像这样的开源软件项目中。
许可
Yasumi是开源软件,根据MIT许可(MIT)许可。有关更多信息,请参阅LICENSE。