Download the PHP package r28/holiday-jp without Composer
On this page you can find all versions of the php package r28/holiday-jp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download r28/holiday-jp
More information about r28/holiday-jp
Files in r28/holiday-jp
Package holiday-jp
Short Description 日本の祝日判定 / Judges datetime japanese holiday
License MIT
Informations about the package holiday-jp
HolidayJp
日本の祝日を判定するライブラリ。 Japanese Holiday judgement library
日付を与えると
- 祝日の場合 : 祝日名
- 祝日でない場合: false
を返す。
Requirements
HolidayJp requires the following to run:
- PHP > 7.1
- composer
- r28/AstroTime
- laktak/hjson
Install
Use composer:
Usage
-
日付を指定してインスタンスを生成した後に祝日判定 [holidayName()]
-
インスタンスを生成後に日付を指定して祝日判定
-
Staticに 日付文字列 指定で祝日判定 [holidayNameFromDate()]
-
Staticに UnixTimestamp 指定で祝日判定 [holidayNameFromTimestamp()]
-
Staticに ユリウス日 指定で祝日判定 [holidayNameFromJulian()]
-
Staticに 年 を指定で1年間の祝日を Array で取得 [holidayNamesFromYear()]
- 第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()]
- 第1引数 : 年(integer)
- 第2引数 : 月(integer)
- 第3引数以降は holidayNamesFromYear() の第2引数以降と同様
-
Staticに 開始日, 終了日 を日付文字列で指定して指定期間の祝日を Array で取得 [itteratePeriodsFromDate() ]
- 第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]=>
), .. )
- Array( [日付] => Array( [name]=><祝日名称>, [time]=>
-
Staticに ディレクトリ, ファイル名, 期間指定で当該期間各日の祝日名をCSV出力 [exportCsvForPeriodsFromDate() ]
- 第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」に設定する。 但し、設定した場合は他の祝日や振替休日など一切に優先する。
設定が空の場合は無視される
Additional_Holidays.hjson の設定例
更新履歴
- v1.2.2 : 2020/12/02 : 追加の固定休日設定を追加
- v1.2.1 : 2020/11/27 : 2021年オリパラ特措法改正に対応(2021年7月~8月の祝日の移動)