日付に関するWEB-API(Webサービス)です。
日付が祝祭日であるかの判定結果などを返します。
method:GET
format:json
charset:UTF-8
url:https://ws.pullup.net/jcalendar.php
以下、先頭に'*'が付いている引数は省略可能であることを表す。
・祝祭日判定バージョン番号取得
引数
cmd=0
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=0
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁
2020年12月9日現在は2020年に公表された最新の官報を参考にしているため"202000"が返ります。
以前は"201800"でした。 |
・祝祭日判定結果取得
引数
cmd=1
year=西暦4桁(1960-2099)
month=月(1-12)
day=(1-31)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=1&year=2020&month=8&day=10
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'month' | | 月 |
| 'day' | | 日 |
| 'holiday' | | 祝祭日であれば'y'、それ以外は'n' |
| 'name' | | 'holiday'が'n'であれば祝祭日の名称 |
・祝祭日一覧取得(指定年、指定月)
引数
cmd=2
year=西暦4桁(1960-2099)
*month=月(1-12)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=2&year=2020
https://ws.pullup.net/jcalendar.php?cmd=2&year=2020&month=5
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'month' | | 月(指定された場合) |
| 'holidays' | | 祝祭日の配列[ |
| 'mmdd' | | 月日(3or4桁) |
| 'name' | | 祝祭日の名称 |
| ] | | |
・祝祭日一覧取得(指定範囲)
引数
cmd=10
range=yyyymmdd-yyyymmdd
※開始年月日-終了年月日
※西暦4桁(1960-2099)、月(1-12)、日(1-31)
*CSV
※CSV形式で出力
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=10&range=20200110-20210110
返却値(JSON)
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'holidays' | | 祝祭日の配列[ |
| 'yyyymmdd' | | 年月日(8桁) |
| 'name' | | 祝祭日の名称 |
| ] | | |
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=10&range=20251001-20260930&CSV
返却値(CSV)
2025/10/13,スポーツの日
2025/11/03,文化の日
2025/11/23,勤労感謝の日
2025/11/24,振替休日
2026/01/01,元日
2026/01/12,成人の日
2026/02/11,建国記念の日
2026/02/23,天皇誕生日
2026/03/20,春分の日
2026/04/29,昭和の日
2026/05/03,憲法記念日
2026/05/04,みどりの日
2026/05/05,こどもの日
2026/05/06,振替休日
2026/07/20,海の日
2026/08/11,山の日
2026/09/21,敬老の日
2026/09/22,国民の休日
2026/09/23,秋分の日
※1960年～2099年までのCSV形式テキストファイル(UTF-8)holidays1960-2099.txt。
・西暦和暦変換
引数
cmd=3
year=西暦4桁(1960-2099)
month=月(1-12)
day=日(1-31)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=3&year=2019&month=4&day=30
https://ws.pullup.net/jcalendar.php?cmd=3&year=2019&month=5&day=1
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'month' | | 月 |
| 'day' | | 日 |
| 'era_name' | | 元号名 |
| 'era_year' | | 和暦年(1-) |
・１ヶ月分のカレンダーを取得
引数
cmd=4
year=西暦4桁(1960-2099)
month=月(1-12)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=4&year=2000&month=2
https://ws.pullup.net/jcalendar.php?cmd=4&year=2020&month=2
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'month' | | 月 |
| 'days' | | 日数(1-31) |
| 'daytbl' | | 日情報の配列 [ |
| 'week' | | 曜日(0=日、1=月、、6=土) |
| 'holiday' | | 祝祭日であれば'y'、それ以外は'n' |
| 'name' | | 祝祭日の名称 |
・１年分のカレンダーを取得
引数
cmd=11
year=西暦4桁(1960-2099)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=11&year=2024
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'era_name' | | 元号名 |
| 'era_year' | | 和暦年(1-) |
| 'months' | | 月数(12) |
| 'monthtbl' | | 月情報の配列 [ |
| 'days' | | 日数(28-31) |
| 'daytbl' | | 日情報の配列 [ |
| 'week' | | 曜日(0=日、1=月、、6=土) |
| 'holiday' | | 祝祭日であれば'y'、それ以外は'n' |
| 'name' | | 祝祭日の名称 |
| 'era_name' | | 元号名(元号が変わった場合のみ出力) |
・曜日取得
引数
cmd=5
year=西暦4桁
month=月(1-12)
day=(1-31)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=5&year=2020&month=8&day=10
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'month' | | 月 |
| 'day' | | 日 |
| 'week' | | 0=日曜日、1=月、2=火、3=水、4=木、5=金、6=土 |
備考
ツェラーの公式で計算しています。
・月内週番号取得
引数
cmd=6
year=西暦4桁
month=月(1-12)
day=(1-31)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=6&year=2020&month=8&day=10
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'month' | | 月 |
| 'day' | | 日 |
| 'no' | | 1=第1週... |
・月内曜日番号取得
引数
cmd=7
year=西暦4桁
month=月(1-12)
day=(1-31)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=7&year=2020&month=8&day=10
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'month' | | 月 |
| 'day' | | 日 |
| 'no' | | 1=第1W曜日... |
・次の平日を取得
引数
cmd=9
year=西暦4桁(1960-2099)
month=月(1-12)
day=(1-31)
*HolidayFlag=休日と見なす曜日(1=日,2=月,4=火,8=水,16=木,32=金,64=土の各OR値。省略時=1or64)
呼び出し例
https://ws.pullup.net/jcalendar.php?cmd=9&year=2020&month=5&day=1
返却値
| 'status' | | 'ok' or 'ng'
|
| 'version' | | 祝祭日バージョン番号(yyyynn) ※西暦4桁+通番2桁 |
| 'year' | | 西暦4桁 |
| 'month' | | 月 |
| 'day' | | 日 |
| 'HolidayFlag' | | 休日と見なす曜日 |
| 'nextyear' | | 西暦4桁 |
| 'nextmonth' | | 月 |
| 'nextday' | | 日 |
・補足など
- (当然ですが)土・日曜日は祝祭日とは見なしません。
振替休日は祝祭日と見なして返します。
- 本サービスが返す祝祭日判定は内閣府が公開している祝祭日一覧の内の「1960～2021年」に合致していることを確認していますが、完全性を保証するものではありません。
例えば春分の日や秋分の日はその年の前年に決定・公表されるため、「来年以降の祝祭日判定は予想でしかない」ことをご理解下さい。
- 祝祭日の名称は内閣府が公表したものと必ずしも同じであるとは限りません。
例えば本サービスでは「国民の休日」「振替休日」の名を返しますが、内閣府の公開データでは両者とも「休日」としています。