check(date) ― Dateクラスのオブジェクトによる祝日判定
```
HolidayJapan.check(Date.new(2021,3,20))
=> true
```
name(date) ― 日付が祝日の場合は祝日名を返し、祝日でなければ nil を返す。
```
HolidayJapan.name(Date.new(2021,3,20))
=> "春分の日"
```

print_year(year) ― ある年の祝日一覧をプリント

$ ruby -r holiday_japan -e 'HolidayJapan.print_year 2021'
listing year 2021...
2021-01-01 Fri 元日
2021-01-11 Mon 成人の日
2021-02-11 Thu 建国記念の日
2021-02-23 Tue 天皇誕生日
2021-03-20 Sat 春分の日
2021-04-29 Thu 昭和の日
2021-05-03 Mon 憲法記念日
2021-05-04 Tue みどりの日
2021-05-05 Wed こどもの日
2021-07-22 Thu 海の日
2021-07-23 Fri スポーツの日
2021-08-08 Sun 山の日
2021-08-09 Mon 振替休日
2021-09-20 Mon 敬老の日
2021-09-23 Thu 秋分の日
2021-11-03 Wed 文化の日
2021-11-23 Tue 勤労感謝の日

list_year(year) ― ある年について、 [日付, 祝日名] のArrayを返す

HolidayJapan.list_year(2021)
=> [[#<Date: 2021-01-01 ((2459216j,0s,0n),+0s,2299161j)>, "元日"],
    [#<Date: 2021-01-11 ((2459226j,0s,0n),+0s,2299161j)>, "成人の日"],
    [#<Date: 2021-02-11 ((2459257j,0s,0n),+0s,2299161j)>, "建国記念の日"],
    [#<Date: 2021-02-23 ((2459269j,0s,0n),+0s,2299161j)>, "天皇誕生日"],
    [#<Date: 2021-03-20 ((2459294j,0s,0n),+0s,2299161j)>, "春分の日"],
    [#<Date: 2021-04-29 ((2459334j,0s,0n),+0s,2299161j)>, "昭和の日"],
    [#<Date: 2021-05-03 ((2459338j,0s,0n),+0s,2299161j)>, "憲法記念日"],
    [#<Date: 2021-05-04 ((2459339j,0s,0n),+0s,2299161j)>, "みどりの日"],
    [#<Date: 2021-05-05 ((2459340j,0s,0n),+0s,2299161j)>, "こどもの日"],
    [#<Date: 2021-07-22 ((2459418j,0s,0n),+0s,2299161j)>, "海の日"],
    [#<Date: 2021-07-23 ((2459419j,0s,0n),+0s,2299161j)>, "スポーツの日"],
    [#<Date: 2021-08-08 ((2459435j,0s,0n),+0s,2299161j)>, "山の日"],
    [#<Date: 2021-08-09 ((2459436j,0s,0n),+0s,2299161j)>, "振替休日"],
    [#<Date: 2021-09-20 ((2459478j,0s,0n),+0s,2299161j)>, "敬老の日"],
    [#<Date: 2021-09-23 ((2459481j,0s,0n),+0s,2299161j)>, "秋分の日"],
    [#<Date: 2021-11-03 ((2459522j,0s,0n),+0s,2299161j)>, "文化の日"],
    [#<Date: 2021-11-23 ((2459542j,0s,0n),+0s,2299161j)>, "勤労感謝の日"]]

hash_year(year) ― ある年について、 {日付=>祝日名} のHashを返す

HolidayJapan.hash_year(2021)
=> {#<Date: 2021-01-01 ((2459216j,0s,0n),+0s,2299161j)>=>"元日",
    #<Date: 2021-01-11 ((2459226j,0s,0n),+0s,2299161j)>=>"成人の日",
    #<Date: 2021-02-11 ((2459257j,0s,0n),+0s,2299161j)>=>"建国記念の日",
    #<Date: 2021-02-23 ((2459269j,0s,0n),+0s,2299161j)>=>"天皇誕生日",
    #<Date: 2021-03-20 ((2459294j,0s,0n),+0s,2299161j)>=>"春分の日",
    #<Date: 2021-04-29 ((2459334j,0s,0n),+0s,2299161j)>=>"昭和の日",
    #<Date: 2021-05-03 ((2459338j,0s,0n),+0s,2299161j)>=>"憲法記念日",
    #<Date: 2021-05-04 ((2459339j,0s,0n),+0s,2299161j)>=>"みどりの日",
    #<Date: 2021-05-05 ((2459340j,0s,0n),+0s,2299161j)>=>"こどもの日",
    #<Date: 2021-07-22 ((2459418j,0s,0n),+0s,2299161j)>=>"海の日",
    #<Date: 2021-07-23 ((2459419j,0s,0n),+0s,2299161j)>=>"スポーツの日",
    #<Date: 2021-08-08 ((2459435j,0s,0n),+0s,2299161j)>=>"山の日",
    #<Date: 2021-08-09 ((2459436j,0s,0n),+0s,2299161j)>=>"振替休日",
    #<Date: 2021-09-20 ((2459478j,0s,0n),+0s,2299161j)>=>"敬老の日",
    #<Date: 2021-09-23 ((2459481j,0s,0n),+0s,2299161j)>=>"秋分の日",
    #<Date: 2021-11-03 ((2459522j,0s,0n),+0s,2299161j)>=>"文化の日",
    #<Date: 2021-11-23 ((2459542j,0s,0n),+0s,2299161j)>=>"勤労感謝の日"}

between(from_date,to_date) ― from_date から to_date までの祝日について、{日付=>祝日名}のHashを返す

HolidayJapan.between("2021-4-1","2022-3-31")
=> {#<Date: 2021-04-29 ((2459334j,0s,0n),+0s,2299161j)>=>"昭和の日",
    #<Date: 2021-05-03 ((2459338j,0s,0n),+0s,2299161j)>=>"憲法記念日",
    #<Date: 2021-05-04 ((2459339j,0s,0n),+0s,2299161j)>=>"みどりの日",
    #<Date: 2021-05-05 ((2459340j,0s,0n),+0s,2299161j)>=>"こどもの日",
    #<Date: 2021-07-22 ((2459418j,0s,0n),+0s,2299161j)>=>"海の日",
    #<Date: 2021-07-23 ((2459419j,0s,0n),+0s,2299161j)>=>"スポーツの日",
    #<Date: 2021-08-08 ((2459435j,0s,0n),+0s,2299161j)>=>"山の日",
    #<Date: 2021-08-09 ((2459436j,0s,0n),+0s,2299161j)>=>"振替休日",
    #<Date: 2021-09-20 ((2459478j,0s,0n),+0s,2299161j)>=>"敬老の日",
    #<Date: 2021-09-23 ((2459481j,0s,0n),+0s,2299161j)>=>"秋分の日",
    #<Date: 2021-11-03 ((2459522j,0s,0n),+0s,2299161j)>=>"文化の日",
    #<Date: 2021-11-23 ((2459542j,0s,0n),+0s,2299161j)>=>"勤労感謝の日",
    #<Date: 2022-01-01 ((2459581j,0s,0n),+0s,2299161j)>=>"元日",
    #<Date: 2022-01-10 ((2459590j,0s,0n),+0s,2299161j)>=>"成人の日",
    #<Date: 2022-02-11 ((2459622j,0s,0n),+0s,2299161j)>=>"建国記念の日",
    #<Date: 2022-02-23 ((2459634j,0s,0n),+0s,2299161j)>=>"天皇誕生日",
    #<Date: 2022-03-21 ((2459660j,0s,0n),+0s,2299161j)>=>"春分の日"}

祝日データをCSVに出力

$ ruby -r csv -r holiday_japan -e 'CSV.open("holiday.csv","w"){|c| HolidayJapan.between(2020,2021).each{|a| c<<a}}'

$ head -n3 holiday.csv ; echo ...; tail -n3 holiday.csv
2020-01-01,元日
2020-01-13,成人の日
2020-02-11,建国記念の日
...
2021-09-23,秋分の日
2021-11-03,文化の日
2021-11-23,勤労感謝の日

祝日データ

1948年7月20日(祝日法発令) 以降の祝日に対応
2021年の暦要項まで確認（法改正がない限り以降も有効）
春分の日・秋分の日の計算は2150年まで

Author:

Masahiro TANAKA

Copyright:

(C) Copyright 2003-2020 by Masahiro TANAKA
This program is free software under MIT license.
See LICENSE.txt.
NO WARRANTY.

Version:

2018-04-14  ver 1.4  祝日データ仕様変更、2019,2020年対応
2017-12-01  ver 1.3  print_between 関数追加
2015-04-11  ver 1.2  hash_year, between 関数追加
2014-05-23  ver 1.1  「山の日」追加
2012-12-23  ver 1.0  モジュール名を Holiday から HolidayJapan に変更
2007-08-02  ver 0.9  リファクタリング
2007-03-08  ver 0.8  祝日データクラスを統一、データを配列で記述
2006-02-06  ver 0.7  平成19年(西暦2007年)の暦要項 反映(祝日法改正)
                     Holiday.create_table 修正
                     Holiday.list_year 追加
2003-10-02  ver 0.6  祝日データ追加
2003-09-29  ver 0.5
2003-09-22  ver 0.4
2003-09-20  ver 0.3
2003-09-16  ver 0.2
2003-09-15  ver 0.1

FAQs

What is holiday_japan?

Is holiday_japan well maintained?

Package last updated on 27 Nov 2020

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install