japanese-holidays

2024-01-05 (金) 14:34:30 更新

印刷しないセクションを選択

日本の休日を求めるための javascript ライブラリを npm と github へ公開しました†

祝日名が取れて、なおかつメンテナンスしやすい形のライブラリが見付からなかったので書いてみました。

一応、複数のライブラリと突き合わせて齟齬がないことを確認しましたが、運用は個々の責任でお願いします。ミスがあれば教えてください。

法律改正などで休日が変更になっても、よほどのことがない限り definition のところをいじるだけで対応できるはずです。

もともとこのライブラリは 2013 年に書かれた物です。 2016年から「山の日」が新設されましたが、これに対するコードの追加は、

LANG: javascript
   [ "山の日",                   simpleHoliday( 8, 11), 2016       ],

の一行だけで済みました。

ライセンスは MIT です。煮るなり焼くなり好きにしてください。

使い方†

npm を使うなら、

LANG:console
$ npm i japanese-holidays
$ node
> Holidays = require('japanese-holidays');
> Holidays.getHolidaysOf(2016);
[ { month: 1, date: 1, name: '元日' },
  { month: 1, date: 11, name: '成人の日' },
  { month: 2, date: 11, name: '建国記念の日' },
  { month: 3, date: 20, name: '春分の日' },
  { month: 3, date: 21, name: '振替休日' },
  { month: 4, date: 29, name: '昭和の日' },
  { month: 5, date: 3, name: '憲法記念日' },
  { month: 5, date: 4, name: 'みどりの日' },
  { month: 5, date: 5, name: 'こどもの日' },
  { month: 7, date: 18, name: '海の日' },
  { month: 8, date: 11, name: '山の日' },
  { month: 9, date: 19, name: '敬老の日' },
  { month: 9, date: 22, name: '秋分の日' },
  { month: 10, date: 10, name: '体育の日' },
  { month: 11, date: 3, name: '文化の日' },
  { month: 11, date: 23, name: '勤労感謝の日' },
  { month: 12, date: 23, name: '天皇誕生日' } ]
> Holidays.isHoliday(new Date(2016,3-1,20));
'春分の日'
> Holidays.isHoliday(new Date(2016,3-1,21));
'振替休日'

npm を使わないなら、
　https://cdn.rawgit.com/osamutake/japanese-holidays-js/v1.0.6/lib/japanese-holidays.js
を読み込めば JapaneseHolidays に必要な関数が入ってきます。

LANG:javascript
<script src="https://cdn.rawgit.com/osamutake/japanese-holidays-js/v1.0.6/lib/japanese-holidays.js"></script>
<script>
  alert( JapaneseHolidays.isHoliday(new Date(2016,3-1,20)) );
</script>

さらにちゃんとした例をこちらに置きました。

　http://jsbin.com/qicazaroxu/edit?js,output

リンク先では上記ライブラリを使って休日入りのカレンダーを表示しています。

休日の上にマウスカーソルを置くと、休日名がツールチップとして表示されるはずです。
（下はスクリーンキャプチャーですので表示されている休日名は変化しません）

タイムゾーンについて†

JapaneseHolidays.isHoliday は与えられた「時刻」ではなく「日付」を元に祝日を判定します。例えばニュージーランドで

LANG:javascript
JapaneseHolidays.isHoliday(new Date(2016,3-1,8));

とすると、ニュージーランド時間の 2016-03-08 00:00:00 が関数に渡されます。これは日本時間では 2016-03-07 21:00:00 を表しますが、 isHoliday は与えられた日付 3/8 が休日かどうかを判定するということです。

多くの場合これは利用者の意図するところだと思います。

万一、与えた「時刻」において日本で休日かどうかを判定する必要があれば、

LANG:javascript
JapaneseHolidays.isHolidayAt(new Date(2016,3-1,8));

を呼んでください。例えばニュージーランドでこれを呼べば、3/7 が休日かどうかが判定されます。

2019年の改元に対応するためアップデート (v1.0.7)†

普段やり慣れないことで手順を思い出す（調べる）のにとても苦労したためメモしておく。

GitHub でプルリクエストをマージした
ローカルに git clone した
npm install した
必要部分を修正して make test が通るようにした
package.json のバージョン番号を 1.0.7 にした
README.md のバージョン番号相当部分を 1.0.7 にした
git push した
GitHub でリリースを作成した
npm adduser でログイン情報を登録した
npm publish した

2021年のオリンピック対応に対応するためアップデート (v1.0.10)†

普段やり慣れないことで手順を思い出す（調べる）のにとても苦労したためメモしておく。っていうか、上記のメモを見つけられずまたもや車輪を再発明してしまった orz

GitHub でプルリクエストをマージした
ローカルに git clone した
npm install した
必要部分を修正して make test が通ることを確認した
package.json のバージョン番号を 1.0.10 にした
README.md のバージョン番号相当部分を 1.0.10 にした
README.md の Change Log を更新しそこなった（どうやって直したらいいか分かってない...）
git commit -a -m "prepare for v1.0.10" した
git push した
GitHub でリリースを作成し、その際にタグをつけた
npm adduser でログイン情報を登録した
npm publish ./ した

更新が遅くなってしまい多方面にご迷惑をおかけいたしました。

大変申し訳ありません。

分かっていないこと：†

npm install で coffee-script に deprecated が出るのだけれど、どう直すのが影響が少ないかわからない
package-lock.json を .gitignore に入れてしまっていいものか判断できない
一旦リリースしてミスがあったら再リリースしなければならないんだろうなあ、やっぱり orz

春分・秋分の計算について（メモ）†

現在のコードでは、

春分・秋分の日は年によって日付が異なります。

この理由は、暦の上での１年の長さが閏年分だけ等間隔にならないため、本来ほぼ正確に等間隔でやってくる春分・秋分の日付がカレンダー上でずれてしまうためです。とはいえ、春分・秋分の間隔も完全に等間隔ではなく、毎年少しずつ揺れ動くようです。

Wikipedia の春分・秋分のページに 1600年～2399年のデータがあって、そこから周期を求めることで、春分についてはすべての範囲で計算と実測とが一致しました。秋分についてはふらつきが大きいようで、計算だけではどうしても一致しなかったため、いくつかの値についてのみ個別に指定しています。

結果として、1600年～2399年の範囲で上記 Wikipedia のページにあった日付を再現できています。

としているのだけれど、

Wikipedia にある太陽年のページの数式と、TAIとUTCの変換ライブラリとを使うとすべて単純計算できるのか、それ以外に揺らぎがあるのか、後で試してみたくなりました。

https://ja.wikipedia.org/wiki/%E5%A4%AA%E9%99%BD%E5%B9%B4

https://fukuno.jig.jp/3430