旧暦、六曜を取得できるAPIを無料で提供しています。 |
 |
|
 |
■ 暦APIとは
リクエストされた日付の 旧暦、十二支、十支、節気、六曜等の情報をjsonデータを提供します。
使用料金は必要ありません。 無償での提供になります。
|
■ 更新履歴
2025-02-11 --
一粒万倍日フラグ追加
天赦日フラグ追加
大明日フラグ追加
サンプルページ更新
|
■ 注意事項
無茶な使い方をされる方がいます
レンタルサーバーですので秒間に何百ものリクエストを投げられても応答できません
|
■ 仕様
・リクエストURL
https://koyomi.zingsystem.com/api/
https://koyomi.zing2.org/api/(廃止)
|
・リクエストパラメータ
パラメータ名 |
項目名 |
必須 |
備考 |
mode |
取得区分 |
○ |
d:日単位 、 m:月単位 |
cnt |
取得数 |
○ |
取得区分=d 取得する日数 1~365が指定可能
取得区分=m 取得する月数 1~12が指定可能
|
targetyyyy |
年 |
○ |
yyyy
*1~2200までが指定可能です。
|
targetmm |
月 |
○ |
mm |
targetdd |
日 |
△ |
dd 取得区分がdの場合のみ必須 mの場合は無視 |
・レスポンス
フィールド名 |
項目名 |
必須 |
備考 |
datelist |
日付リスト |
○ |
yyyy-mm-dd 形式 |
以下日付ごとに配列 |
|
week |
曜日 |
○ |
月 火 水 木 金 土 日(ツェラーの公式使用) |
|
inreki |
陰暦 |
○ |
"睦月", "如月", "弥生", "卯月", "皐月", "水無月","文月", "葉月", "長月", "神無月", "霜月", "師走" |
|
zyusi |
十支 |
○ |
"甲","乙","丙","丁","戊","己","庚","辛","壬","癸" |
|
zyunisi |
十二支 |
○ |
"子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥" |
|
eto |
干支 |
○ |
"子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥" |
|
gengo |
元号 |
○ |
"令和","平成","昭和","大正","明治" |
|
wareki |
和暦 |
○ |
|
|
sekki |
節気 |
|
"春分","清明","穀雨","立夏","小満","芒種","夏至","小暑","大暑","立秋","処暑","白露", "秋分","寒露","霜降","立冬","小雪","大雪","冬至","小寒","大寒","立春","雨水","啓蟄" |
|
kyurekiy |
旧暦 年 |
○ |
|
|
kyurekim |
旧暦 月 |
○ |
|
|
kyurekid |
旧暦 日 |
○ |
|
|
rokuyou |
六曜 |
○ |
"大安","赤口","先勝","友引","先負","仏滅" |
|
holiday |
祝日 |
|
1948年~2045年まで |
|
hitotubuflg |
一粒万倍日フラグ |
○ |
該当日:true 非該当日:false |
|
tensyabiflg |
天赦日 |
○ |
該当日:true 非該当日:false |
|
daimyoubiflg |
大明日 |
○ |
該当日:true 非該当日:false |
・サンプルレスポンス
{
"datelist":{
{"2025-02-11":{
"week":"火",
"inreki":"如月",
"gengo":"令和",
"wareki":7,
"zyusi":"辛",
"zyunisi":"亥",
"eto":"巳",
"sekki":"",
"kyurekiy":2025,
"kyurekim":1,
"kyurekid":14,
"rokuyou":"友引",
"holiday":"建国記念の日",
"hitotubuflg":false,
"tensyabiflg":false,
"daimyoubiflg":true
}
}
}
|
・エラー
フィールド名 |
項目名 |
必須 |
備考 |
err |
エラーコード |
○ |
400:必須エラー
401:パラメータ値エラー
|
mes |
エラーメッセージ |
○ |
|
・サンプルレスポンス
{
"err":400,
"mes":"必須パラメータが指定されていません。"
}
|
|
|