旧暦、六曜を取得できる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":"必須パラメータが指定されていません。"
}



  Copyright 2015 All rights reserved.