holidays

开源

一系列 Ruby 方法,用于处理法定假日和其他假日。你值得放个假!

879 stars0 点赞1 次浏览

工具介绍

一系列 Ruby 方法,用于处理法定假日和其他假日。你值得放个假!

Ruby Holidays Gem()

Ruby 中处理节假日的功能。扩展了 Ruby 的内置日期和时间类,并支持自定义节假日定义列表。所有节假日定义都保存在 holidays/definitions 仓库中。默认情况下,此 gem 返回法定节假日(由政府正式定义的节假日)。通过 :informal 选项可以获取文化上认可但不是法定节假日(如情人节)。有关节假日分类的详细信息,请参阅定义语法指南。

安装

gem install holidays

已测试的版本

此 gem 经过以下 Ruby 版本的测试:

3.3
3.4
4.0
JRuby 10.0.5.0
JRuby 10.1.0.0

Semver

此 gem 遵循语义版本管理。保证具体包括：

最顶层 Holidays 命名空间中的方法,例如 Holidays.
[核心扩展](#扩展 Ruby 的日期和时间类) 请注意,我们将定义更改视为"小幅"变化,这意味着它们与您的代码兼容,但可能会产生不同的节假日结果!

时区

时间区域将被忽略。此库假定所有日期都位于同一个时间区域。

使用方法

此插件提供了多种方法来检查各种场景中的节假日。

检查特定日期

查看 2008 年 4 月 25 日在澳大利亚的所有假日:

ruby

Holidays.on(Date.new(2008, 4, 25), :au)
=> [{:name => 'ANZAC Day',...}]

您可以在一次呼叫中检查多个区域:

ruby

Holidays.on(Date.new(2008, 1, 1), :us, :fr)
=> [{:name=>"New Year's Day", :regions=>[:us],...},
    {:name=>"Jour de l'an", :regions=>[:fr],...}]

您可以省略 'regions' 以获取我们定义中任何区域的假期:

ruby

Holidays.on(Date.new(2007, 4, 25))
=> [{:name=>"ANZAC Day", :regions=>[:au], ...},
{:name=>"解放节", :regions=>[:it], ...},
{:name=>"自由日", :regions=>[:pt], ...}