简介:农历阴历黄历API免费调用,可显示公历、星期、星座、农历阴历、节日、节气、儒略日、佛历、道历、生肖、干支、五行、生辰八字、纳音、十神、起运时间、彭祖百忌、数九、三伏、喜神财神福神方位、阴阳贵神方位、胎神方位、太岁方位、冲煞、宜忌、禄神、物候、六曜、七政、四兽、二十八星宿、星宿歌决、灶马头、建除十二值星、十二天神、九星、每日一言 等信息(此版本为Pro版本)。1
通过参数date传入14位日期时间,格式如:20240102081420,或完整的标准时间格式:2024-01-02 08:14:20,如格式和时间错误,返回当前时间信息,可空参数传入,将返回当前时间信息,部分健值比如节日、数九、三伏等因具有时节性,返回可能为空,将会自动隐藏此类空值,具体键值对应返回信息及说明详见下表。
接口地址(此文章将不再更新访问api主站最新信息):
1、精简版:https://api.shwgij.com/doc/6
2、完整版:https://api.shwgij.com/doc/7
返回格式:JSON
请求方式:GET
调用参数:date=2024010112150832&key=XXXXXXXX
接口传入参数说明:
接口名称 | 是否必填 | 接口类型 | 接口说明 |
空 | 否 | string | 默认为当前日期 |
dete | 否 | string | 可指定日期:2024010112150832 |
key | 否 | string | 使用key获得更多资源 |
键值内容说明:2
Key | 数据示例 | 值类型 | 说明(所有当前均指传入日期) |
Code | 200 | 数字 | HTTP响应状态码,表示成功 |
Msg | ture | 布尔值 | ture表示成功,false表示失败 |
Version | Pro | 字符串 | Pro专业版本,Simple精简版 |
Update | 2024-01-15 | 字符串 | 更新此版本的时间 |
Exec_Time | 0.15681s | 字符串 | 执行时间,单位秒 |
Date | { } | 数据组 | 列举所有Key,空值会自动隐藏 |
Solar | 2024年1月1日 | 字符串 | 返回公历日期 |
Week | 星期一 | 字符串 | 返回星期 |
Constellation | 巨蟹座 | 字符串 | 返回星座 |
Festivals | 元旦节 | 字符串 | 常见的国际节日,可能为空 |
OtherFestivals | 中国人民警察节 | 字符串 | 其他公历纪念日,可能为空 |
JulianDay | 儒略日 | 数字 | 返回儒略日 |
LunarYear | 二〇二三年 | 字符串 | 返回农历年 |
Lunar | 冬月廿九日 | 字符串 | 返回农历月和日 |
FoDate | 二五六七年冬月廿九日 | 字符串 | 返回佛历年月日 |
DaoDate | 四七二〇年冬月廿九日 | 字符串 | 返回道历年月日 |
ThisYear | 龙年 | 字符串 | 返回当前年份生肖 |
GanZhiYear | 癸卯年 | 字符串 | 返回年干支 |
GanZhiMonth | 乙丑月 | 字符串 | 返回月干支 |
GanZhiDay | 癸酉日 | 字符串 | 返回日干支 |
GanZhiHour | 甲子时 | 字符串 | 返回时干支 |
WuXingYear | 水木 | 字符串 | 返回年五行 |
WuXingMonth | 木土 | 字符串 | 返回月五行 |
WuXingDay | 水金 | 字符串 | 返回日五行 |
WuXingHour | 木水 | 字符串 | 返回时五行 |
NaYinYear | 金箔金 | 字符串 | 返回年纳音 |
NaYinMonth | 海中金 | 字符串 | 返回月纳音 |
NaYinDay | 剑锋金 | 字符串 | 返回日纳音 |
NaYinHour | 海中金 | 字符串 | 返回时纳音 |
ShiShenYear | 食神 | 字符串 | 返回年十神 |
ShiShenMonth | 七杀 比肩 偏印 | 字符串 | 返回月十神 |
ShiShenDay | 偏印 | 字符串 | 返回日十神 |
ShiShenHour | 比肩 | 字符串 | 返回时十神 |
QiYunMan | 出生1年7个月0天后起运 | 字符串 | 返回男性自出生起的起运时间 |
QiYunWoman | 出生8年3个月0天后起运 | 字符串 | 返回女性自出生起的起运时间 |
PengZuBaiJi | 癸不词讼理弱敌强… | 字符串 | 返回彭祖百忌 |
JieQi1 | 小寒 第5天 | 字符串 | 返回当前所在节气的天数 |
JieQi2 | 距离 大寒 还有10天 | 字符串 | 返回下一个节气距当前的天数 |
PrevJieQi | 小寒 2024-01-06 04:49:20 | 字符串 | 返回上一个节气的名称和时间 |
NextJieQi | 大寒 2024-01-20 22:07:20 | 字符串 | 返回下一个节气的名称和时间 |
YueXiang | 晓 | 字符串 | 返回当前月相 |
ShuJiu | 三九 第2天 | 字符串 | 返回数九以及天数,可能为空 |
SanFu | 初伏 第2天 | 字符串 | 返回三伏及天数,可能为空 |
Lunar_Festivals | 春节 | 字符串 | 常见农历节日,可能为空 |
Lunar_OtherFestivals | 填仓节 | 字符串 | 其他农历节日,可能为空 |
XiShen | 巽=东南 | 字符串 | 返回喜神方位 |
CaiShen | 离=正南 | 字符串 | 返回财神方位 |
FuShen | 艮=东北 | 字符串 | 返回福神方位 |
YangGuiShen | 巽=东南 | 字符串 | 返回阳贵神方位 |
YinGuiShen | 巽=正东 | 字符串 | 返回阴贵神方位 |
TaiShenDay | 房床门 外西南 | 字符串 | 返回日胎神方位 |
TaiShenMonth | 占灶炉 | 字符串 | 返回月胎神方位 |
TaiSuiYear | 癸卯 震=正东 | 字符串 | 返回年太岁方位 |
TaiSuiMonth | 乙丑 巽=东南 | 字符串 | 返回月太岁方位 |
TaiSuiDay | 癸酉 震=正东 | 字符串 | 返回日太岁方位 |
ChongDay | 鸡日冲(丁卯)兔 | 字符串 | 返回日冲 |
ShaDay | 东 | 字符串 | 返回日煞 |
ChongHour | 鼠时冲(戊午)马 | 字符串 | 返回时冲 |
ShaHour | 南 | 字符串 | 返回时煞 |
JiShenDay | 母仓 金堂 除神 明堂 鸣吠 | 字符串 | 返回日吉神 |
XiongShaDay | 河魁 大时 大败 咸池 | 字符串 | 返回日凶煞 |
YiDay | 入殓 除服 成服 移柩 启钻.. | 字符串 | 返回日宜 |
JiDay | 破土 伐木 | 字符串 | 返回日忌 |
YiHour | 祈福 求嗣 订婚 嫁娶 入宅 .. | 字符串 | 返回时宜 |
JiHour | 赴任 修造 移徙 出行 词讼 | 字符串 | 返回时忌 |
LuDay | 子命互禄 辛命进禄 | 字符串 | 返回日禄 |
WuHou | 雁北乡 小寒 初候 | 字符串 | 返回物侯 |
LiuYao | 先负 | 字符串 | 返回六曜 |
QiZheng | 水 | 字符串 | 返回七政 |
SiShou | 朱雀 | 字符串 | 返回四兽 |
XiuLuck | 南 轸 水 蚓 吉 | 字符串 | 返回二十八星宿 |
XiuSong | 轸星临水造龙宫,代代 … | 字符串 | 返回星宿歌诀 |
ZaoMaTou | 九鼠偷粮 草子九分 … | 字符串 | 返回灶马头,几鼠偷… |
ZhiXing | 成 | 字符串 | 返回建除十二值星 |
TianShen | 勾陈 黑道 凶 | 字符串 | 返回十二天神 |
JiuXingYear | 四绿木天权 => 四绿木 … | 字符串 | 返回值年九星 |
JiuXingMonth | 六白金开阳 => 六白金… | 字符串 | 返回值月九星 |
JiuXingDay | 一白水天枢 => 一白水 … | 字符串 | 返回值日九星 |
JiuXingHour | 一白水天枢 => 一白水… | 字符串 | 返回值时九星 |
WeiYu_s | 相信自己,你 … | 字符串 | 微语短版,<20字,每天一句 |
WeiYu_l | 不要让别人的意见和 … | 字符串 | 微语长版,>30字,每天一句 |
WeiXin | 微信公众号:相见拾光 | 字符串 | 返回微信公众号:相见拾光 |
Url | blog.shwgij.com | 字符串 | 返回博客地址 |
精简版请求示例:(本示例为升级版本数据结构)
{
"Code": 200,
"Msg": true,
"Version": "Simple",
"Update": "2014-01-05",
"Exec_Time": "0.18765s",
"Data": {
"Solar": "2024年1月14日",
"Week": "星期日",
"Constellation": "摩羯座",
"Festivals": "元旦节",
"OtherFestivals": "日记情人节",
"LunarYear": "二〇二三年",
"Lunar": "腊月初四",
"ThisYear": "兔年",
"GanZhiYear": "癸卯年",
"JieQi1": "小寒 第9天",
"Lunar_Festivals": "春节",
"Lunar_OtherFestivals": "填仓节",
"WeiYu_s": "坚持不懈是成功的关键,不要停下脚步。",
"WeiYu_l": "坚持努力,即使进展缓慢,也要相信未来的成就将会更加辉煌。",
"WeiXin": "微信公众号:相见拾光",
"Url": "blog.shwgij.com"
}
}
完整版请求示例(部分键值因长度较多已经做省略,实际调用时为完整数据):
{
"Code": 200,
"Msg": true,
"Version": "Pro",
"Update": "2014-01-05",
"Exec_Time": "0.33548s",
"Data": {
"Week": "星期四",
"Constellation": "摩羯座",
"JulianDay": 2460320.9880208,
"LunarYear": "二〇二三年",
"Lunar": "腊月初一日",
"FoDate": "二五六七年腊月初一日",
"DaoDate": "四七二〇年腊月初一日",
"ThisYear": "兔年",
"GanZhiYear": "癸卯年",
"GanZhiMonth": "乙丑月",
"GanZhiDay": "甲戌日",
"GanZhiHour": "庚午时",
"WuXingYear": "水木",
"WuXingMonth": "木土",
"WuXingDay": "木土",
"WuXingHour": "金火",
"NaYinYear": "金箔金",
"NaYinMonth": "海中金",
"NaYinDay": "山头火",
"NaYinHour": "路旁土",
"ShiShenYear": "劫财",
"ShiShenMonth": "正财 正印 正官",
"ShiShenDay": "偏财 正官 伤官",
"ShiShenHour": "伤官 正财",
"QiYunMan": "出生1年9个月10天后起运",
"QiYunWoman": "出生8年0个月20天后起运",
"PengZuBaiJi": "甲不开仓财物耗散 戌不吃犬作怪上床",
"JieQi1": "小寒 第6天",
"JieQi2": "距离 大寒 还有9天",
"PrevJieQi": "小寒 2024-01-06 04:49:20",
"NextJieQi": "大寒 2024-01-20 22:07:20",
"YueXiang": "朔",
"ShuJiu": "三九 第3天",
"SanFu": "初伏 第3天",
"Lunar_Festivals": "春节",
"Lunar_OtherFestivals": "填仓节",
"XiShen": "艮=东北",
"CaiShen": "艮=东北",
"FuShen": "坎=正北",
"YangGuiShen": "坤=西南",
"YinGuiShen": "坤=东北",
"TaiShenDay": "占门栖 外西南",
"TaiShenMonth": "占房床",
"TaiSuiYear": "癸卯 震=正东",
"TaiSuiMonth": "乙丑 巽=东南",
"TaiSuiDay": "甲戌 震=正东",
"ChongDay": "狗日冲(戊辰)龙",
"ShaDay": "北",
"ChongHour": "马时冲(甲子)鼠",
"ShaHour": "北",
"JiShenDay": "月空 四相 圣心 青龙",
"XiongShaDay": "天罡 月刑 五虚 八风",
"YiDay": "祭祀 祈福 斋醮 塑绘 开光 除服 成服 入殓 作...",
"JiDay": "开仓 盖屋 安葬 安床",
"YiHour": "祈福 求嗣 订婚 嫁娶 出行 求财 开市 交易 安床",
"JiHour": "赴任 词讼 修造 动土",
"LuDay": "寅命互禄",
"WuHou": "鹊始巢 小寒 二候",
"LiuYao": "赤口",
"QiZheng": "木",
"SiShou": "青龙",
"XiuLuck": "东 角 木 蛟 吉",
"XiuSong": "角星造作主荣昌,外进田财及女郎,嫁娶...",
"ZaoMaTou": "九鼠偷粮 草子九分 十牛耕田 花收十二分...",
"ZhiXing": "收",
"TianShen": "青龙 黄道 吉",
"JiuXingYear": "四绿木天权 => 四绿木 巽(东南) 天权 玄...",
"JiuXingMonth": "六白金开阳 => 六白金 乾(西北) 开阳 玄...",
"JiuXingDay": "二黒土天璇 => 二黒土 坤(西南) 天璇 玄...",
"JiuXingHour": "一白水天枢 => 一白水 坎(正北) 天枢 玄...",
"WeiYu_s": "不要停下脚步,成功在前方等待。",
"WeiYu_l": "学会从他人的成功中汲取灵感和经验,但不要嫉妒和羡...",
"WeiXin": "微信公众号:相见拾光",
"Url": "blog.shwgij.com"
}
}
使用说明:
不带参数可返回当前日期的公历、农历、节气、属相、每日一言等信息,带日期参数可返回指定日期的信息,token为可选。
- 白名单调用:可控制调用次数和重置时长,可控制不受频次限制。
- 非token调用:每天可请求100次,次日0点自动重置。
- 共享token:免费使用,会限制总调用次数,由多人共享使用同一token,同时也会受截止时间限制。通常情况下,一枚新的token,总请求次数为10000次,有效期为1个月,通过公众号获取。
- 独享token:独立token,无使用时间限制,根据实际获取情况,控制总调用次数(通过捐赠获取)。
- 获取token:关注微信公众号 相见拾光 免费获取共享token。

