r28/holiday-jp

日本の祝日判定 / Judges datetime japanese holiday

v1.2.2 2020-12-02 09:14 UTC

This package is auto-updated.

Last update: 2024-02-29 02:39:50 UTC


README

Build Status

日本の祝日を判定するライブラリ。 Japanese Holiday judgement library

日付を与えると

  • 祝日の場合 : 祝日名
  • 祝日でない場合: false

を返す。

Requirements

HolidayJp requires the following to run:

  • PHP > 7.1
  • composer
  • r28/AstroTime
  • laktak/hjson

Install

Use composer:

$ composer require r28/holiday-jp

Usage

<?php
require_once path_to_vendor.'/vendor/autoload.php';
use r28\HolidayJp\HolidayJp;
  • 日付を指定してインスタンスを生成した後に祝日判定 [holidayName()]

    $date = '2019-05-01';
    $holiday = new HolidayJp($date);
    $holiday_name = $holiday->holidayName();
    echo $holiday_name.PHP_EOL;
    # 天皇即位の日
  • インスタンスを生成後に日付を指定して祝日判定

    $date = '2019-05-03';
    $time = new AstroTime($date, 'Asia/Tokyo', false);
    $holiday = new HolidayJp();
    $holiday_name = $holiday->holidayName($time);
    echo $holiday_name.PHP_EOL;
    # 憲法記念日
  • Staticに 日付文字列 指定で祝日判定 [holidayNameFromDate()]

    $holiday_name = HolidayJp::holidayNameFromDate('2019-05-04');
    echo $holiday_name.PHP_EOL;
    # みどりの日
  • Staticに UnixTimestamp 指定で祝日判定 [holidayNameFromTimestamp()]

    $holiday_name = HolidayJp::holidayNameFromTimestamp(1556982000); # 2019/05/05
    echo $holiday_name.PHP_EOL;
    # こどもの日
  • Staticに ユリウス日 指定で祝日判定 [holidayNameFromJulian()]

    $holiday_name = HolidayJp::holidayNameFromJulian(2458609.125);  # 2019/05/06
    echo $holiday_name.PHP_EOL;
    # 振替休日
  • Staticに 年 を指定で1年間の祝日を Array で取得 [holidayNamesFromYear()]

    $holidays = HolidayJp::holidayNamesFromYear(2019, 'date_string', true);
    print_r($holidays);
    
    Array
    (
        [2019-01-01] => 元日
        [2019-01-14] => 成人の日
        [2019-02-11] => 建国記念の日
        ....
        [2019-11-03] => 文化の日
        [2019-11-04] => 振替休日
        [2019-11-23] => 勤労感謝の日
    )
    • 第1引数 : 年(integer)
    • 第2引数 : 返却される Array の Key の形式
      • date_string : Y-m-d (string)
      • date_slash : Y/m/d
      • date_short : Ymd
      • timestamp : Unix Timestamp (integer)
      • julian : ユリウス日 (float)
    • 第3引数: true = 指定期間中の祝日のみを返却する, false = 指定期間全て(祝日でない場合の value は false)
  • Staticに 年月 を指定で1か月の祝日を Array で取得 [holidayNamesFromYearMonth()]

    $holidays = HolidayJp::holidayNamesFromYearMonth(2019, 5, 'date_string', true);
    print_r($holidays);
    
    Array
    (
        [2019-05-01] => 天皇即位の日
        [2019-05-02] => 国民の休日
        [2019-05-03] => 憲法記念日
        [2019-05-04] => みどりの日
        [2019-05-05] => こどもの日
        [2019-05-06] => 振替休日
    )
    • 第1引数 : 年(integer)
    • 第2引数 : 月(integer)
    • 第3引数以降は holidayNamesFromYear() の第2引数以降と同様
  • Staticに 開始日, 終了日 を日付文字列で指定して指定期間の祝日を Array で取得 [itteratePeriodsFromDate() ]

    $holidays = HolidayJp::itteratePeriodsFromDate('2019-01-01', '2019-04-01', 'date_string', true, false);
    print_r($holidays);
    
    Array
    (
        [2019-01-01] => 元日
        [2019-01-14] => 成人の日
        [2019-02-11] => 建国記念の日
        [2019-03-21] => 春分の日
    )
    • 第1引数 : 開始日(string)
    • 第2引数 : 終了日(string)
    • 第2引数 : 返却される Array の Key の形式
      • date_string : Y-m-d (string)
      • date_slash : Y/m/d
      • date_short : Ymd
      • timestamp : Unix Timestamp (integer)
      • julian : ユリウス日 (float)
    • 第3引数: true = 指定期間中の祝日のみを返却する, false = 指定期間全て(祝日でない場合の value は false)
    • 第4引数: true = 返却される Array の Value を祝日名称でなく、AstroTimeオブジェクトを含む Array とする
      • Array( [日付] => Array( [name]=><祝日名称>, [time]=> ), .. )
    $holidays = HolidayJp::itteratePeriodsFromDate('2019-01-01', '2019-04-01', 'date_string', true, true);
    print_r($holidays);
    
    Array
    (
        [2019-01-01] => Array
            (
                [name] => 元日
                [time] => r28\AstroTime\AstroTime Object
                    (
                        [timezoneName] => Asia/Tokyo
                        [local] => Cake\Chronos\Chronos Object
                            (
                                [hasFixedNow] =>
                                [time] => 2019-01-01 00:00:00.000000
                                [timezone] => Asia/Tokyo
                            )
    
                        [utc] => Cake\Chronos\Chronos Object
                            (
                                [hasFixedNow] =>
                                [time] => 2018-12-31 15:00:00.000000
                                [timezone] => UTC
                            )
    
                        [timestamp] => 1546268400
                        [calendar_type] => gregorian
                        [jd] => 2458484.125
                        [mjd] => 58483.625
                        [jc] => 0.18998288843258
    【以下略】
    )
  • Staticに ディレクトリ, ファイル名, 期間指定で当該期間各日の祝日名をCSV出力 [exportCsvForPeriodsFromDate() ]

    define('EXPORT_DIR', '/PATH/TO/exports/');
    HolidayJp::exportCsvForPeriodsFromDate(EXPORT_DIR, 'holidays.csv', '2018-01-01', '2031-12-31');
    $ head /PATH/TO/exports/holidays.csv
    
    ---ここから---
    datetime,timestamp,name
    "2018-01-01",1514732400,元日
    "2018-01-02",1514818800,
    "2018-01-03",1514905200,
    "2018-01-04",1514991600,
    "2018-01-05",1515078000,
    "2018-01-06",1515164400,
    "2018-01-07",1515250800,
    "2018-01-08",1515337200,成人の日
    "2018-01-09",1515423600,
    ---ここまで---
    • 第1引数 : 出力先ディレクトリ(string)
    • 第2引数 : 出力先ファイル名(string)
    • 第3引数 : 期間-始年月日(string)
    • 第4引数 : 期間-至年月日(string)

対応祝日

  • 2019年用の「天皇の即位の日及び即位礼正殿の儀の行われる日を休日とする法律」に対応済
  • 2020年用の「平成三十二年東京オリンピック競技大会・東京パラリンピック競技大会特別措置法 及び 平成三十一年ラグビーワールドカップ大会特別措置法の一部を改正する法律 (平成30年法律第55号)」に対応済
  • 「国民の祝日に関する法律の一部を改正する法律 (平成30年法律第57号)」に対応 (体育の日→スポーツの日)
  • 2021年用の「平成三十二年東京オリンピック競技大会・東京パラリンピック競技大会特別措置法 改正」に対応済

祝日設定

祝日の設定は、src/HolidayJp/settings/*.hjson に HJSONファイル の形式で設置してある。

  • Equinox.hjson 春分・秋分の日 の計算用定数
  • Happy_Mondays.hjson ハッピーマンデー制度で定められている祝日
  • Specified_Moved.hjson 2020年のオリンピック関連特別措置法のように、「ある年だけ別の日に移動し、前後は変更ない」ような祝日
  • Stationaly_Holidays.hjson 上記以外の通常の祝日
  • Additional_Holidays.hjson 追加の固定休日(夏季/年末年始休暇など、期間(始)~(至)の年月日を設定)

追加の固定休日

会社の夏季/年末年始休暇や創立記念日などは、期間(開始日~終了日, 'YYYY-MM-DD'の形式)と名称を「Additional_Holidays.hjson」に設定する。 但し、設定した場合は他の祝日や振替休日など一切に優先する。

【例】"2020-12-29" ~ "2021-01-03" を「冬期休暇」とした場合は、"2021-01-01"は「元日」でなく「冬期休暇」となる。

設定が空の場合は無視される

Additional_Holidays.hjson の設定例

[
    {
        from_date: "2020-12-29"
        to_daet: "2021-01-03"
        name: "冬期休暇"
    }
    {
        from_date: "2021-08-10"
        to_date: "2021-08-16"
        name: "夏季休暇"
    }
]
これの編集スクリプトなどはそのうち...

更新履歴

  • v1.2.2 : 2020/12/02 : 追加の固定休日設定を追加
  • v1.2.1 : 2020/11/27 : 2021年オリパラ特措法改正に対応(2021年7月~8月の祝日の移動)