Amaitorte

日本の祝日 holiday.js

ダウンロードする
バージョン7.0/2019年10月21日更新

日本の祝日のことならこのスクリプト。
holiday.jsは、特定の年月日が国民の祝日かどうかを調べたり、
その祝日の名前を取得する事が出来る簡単なJavaScriptファイルです。

holiday.jsの特徴

基本的な使い方

var holidayname = amaitortedays.isNationalHoliday();

今日が祝日・休日だった場合、その名称が返って来ます。

使い方の一例

<!DOCTYPE html>
<html>
<head>
    <script src="holiday.min.js"></script>
</head>
<body>
    <script>
        var holidayname = amaitortedays.isNationalHoliday();
        if(holidayname){
            document.write('今日は「' + holidayname + '」です!');
        }
    </script>
</body>
</html>

上記のように、今日が祝日だった場合にその名称を表示するといった仕組みを作る事が出来ます。

今日以外の日付を調べる

var someday = new Date("2014/2/11 0:00:00 +0900");
var holidayname = amaitortedays.isNationalHoliday(someday);

引数にDateオブジェクトをブチ込むことで任意の年月日を調べる事が出来ます。

詳しい説明

amaitortedays.isNationalHoliday( [日付 [, 動作モード] ] );

amaitortedays.isNationalHoliday関数には最大二つの引数を入れる事が出来ます。

日付
Dateオブジェクト。任意の年月日・時刻を入力します。何も指定しない場合、現在時刻になります。
動作モード
数値。入力した番号によって、取得する祝日の種別(ジャンル)を選ぶ事が出来ます。(後述)

動作モードの一覧

amaitortedays.isNationalHoliday関数の第二引数で動作モードを指定することで、祝日・休日を検索する範囲を選択することが出来ます。検索対象外の祝日・休日は、例え該当する年月日を入力しても取得されなくなります。

「祝日も振替休日も表示したい」「本来の祝日だけ表示したい」「法令通りの休日カレンダーを作りたい」といった様々なニーズに対応できます。
※ 利用方法によっては誤って不適切な表現になってしまう場合があります。動作モードは慎重に選択して下さい。

0:ニュートラルモード(デフォルト値)
法令上の休日のうち、祝日として扱って差し支えがないもの、
すなわち国民の祝日、振替休日、国民の休日、旧祝祭日、結婚の儀、即位の礼の中から検索します
大喪の礼には検索対象外です。
1:全検索モード
大喪の礼も含め、法令上の休日全ての中から検索します。
2:祝日オンリーモード
法令上の休日のうち、狭義の「国民の祝日」にのみヒットします。
振替休日、国民の休日、旧祝祭日、結婚の儀、即位の礼、大喪の礼には検索対象外です。
3:祝事モード
法令上の休日のうち、祝い事と言える祝日、
すなわち国民の祝日、旧祝祭日、結婚の儀、即位の礼の中から検索します。
振替休日、国民の休日、大喪の礼には検索対象外です。

<script>
    var holidayname = amaitortedays.isNationalHoliday(null, 2);
    if(holidayname){
        document.write('今日は「' + holidayname + '」です!');
    }
</script>

例えば上記のように動作モードを「2」とセットすると、振替休日などは省略し、本来の祝日の日付にだけ祝日の名称が表示されます。

動作モードと検索範囲の対応表

国民の祝日 振替休日・国民の休日 戦前の祝祭日 結婚の儀・即位の礼 大喪の礼
0:ニュートラルモード
1:全検索モード
2:祝日オンリーモード
3:祝事モード

※ 2019年の「天皇の即位の日」および「即位礼正殿の儀の行われる日」は祝日扱いのため、祝日オンリーモードでもヒットします。

利用上のご注意&利用規約

  • 1873年11月〜2150年12月までしか使えません。
  • 1873年10月〜2020年10月現在までの各法令に従っていますが、祝日・休日に関する法令は突然改正される場合があります。定期的に新しいバージョンをダウンロード・差し替えを行って下さい。
  • 作者は、このスクリプトによって表示される祝日・休日等のデータの正確性を保証しません。
  • 作者は、このスクリプトを使用したことによるいかなる損害にも責任を負いません
  • スクリプトの利用方法(例えば、祝日・休日の名称と任意のテキストを組み合わせて表示する場合等)によっては不適切な表現になってしまう場合があります。最新の注意を払ってご使用下さい。
  • このスクリプトの技術的仕様・利用法は予告なく変更される場合があります。
  • このスクリプトの利用方法に関するお問い合わせにはお答えできません。
  • このスクリプトの著作権は作者である猫分儀スミレに帰属します。
  • ウェブサイトでの利用を目的としたウェブサーバへのアップロード、アプリケーションでの利用を目的としたアプリケーションへの同梱などの正当な利用目的のための再配布を除き、無断でこのスクリプトを複製、再配布、公衆送信可能化することは出来ません。
  • スクリプトファイル内の著作権表示を改変したり、取り除くことは出来ません。また、プログラム部分の一部または全部を転載するときは、著作権表示も一緒に転載しなければなりません。