接口线路类型一[集群IP接口-免费]
[接口地址1] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址2] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址3] :当前负载【】 接口通讯【正常

复制

测速 

说明:直接访问https://api.apihz.cn/getapi.php获取当前最优接口地址,IP接口省去域名解析步骤,速度较快。集群IP接口并非永久有效,且容易遭受攻击,建议定期获取当前最优IP接口地址做容错处理,或直接使用域名接口或彩钻接口。IP直链接口CC防火墙严格。
接口线路类型二[域名接口-免费]
[接口地址] :[自动分发到集群接口服务器,但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]

复制

测速 

接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口] :[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。登录后购买。]

复制

测速 

请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)

复制全部

复制参数 

[POST]请求示例(请根据开发语言自行POST)

请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
名称 参数 必填 说明
开发者IDid用户中心的数字ID,例:id=10000000
开发者KEYkey用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2
编码type传1返回GBK编码,不传则默认UTF8编码。例:type=1
动态秘钥dkey开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371
用户IPuip接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。
返回参数说明
名称 参数 说明
状态码code200成功,400错误
信息提示msg信息提示
编号id由年月日组成。
阳历年ynian阳历年
阳历月yyue阳历月
阳历日yri阳历日
星期几WEEKJ星期几,0代表星期日,1代表星期一,6代表星期六
中文星期几xingqi中文星期几
阳历闰年YLLEAP阳历闰年,FALSE=否,TRUE=是
阳历节日jieri阳历节日
星座xingzuo阳历对应的星座
周序号YLWEEKNOR以星期日作为一周的起点,本日是第几周
周序号YLWEEKNOY以星期一作为一周的起点,本日是第几周
本年总天数DAYSOFYEAR本年总天数
本日当年第几天DAYSINYEAR本日为当年第几天
阴历年YIYEAR阴历年
阴历年中文nnian阴历年中文
阴历月YIMONTH阴历月
阴历月中文nyue阴历月中文
阴历日YIDAY阴历日
阴历日中文nri阴历日中文
阴历节日YIFESTIVAL阴历节日
年干支YEARGANZHI年干支,新年以正月初一起算
年干支ganzhinian年干支,新年以立春零点起算
年干支YEARINGANZHIEXACT年干支,新年以立春交接时刻为准
月干支ganzhiyue月干支,新的一月以节交接当天零点起算
月干支MONTHINGANZHIEXACT月干支,新的一月以节交接准确时刻起算
日干支ganzhiri日干支,阴历日干支
日干支DAYINGANZHIEXACT日干支,晚子时算明天
日干支DAYINGANZHIEXACT2日干支,晚子时算当天
日禄DAYLU日禄
日生肖DAYSHENGXIAO日的生肖
节气JIEQICN节气的第几天描述
节气jieqi节气
节气JIEQIDAYS节气天数
物候WUHOU当天物候
数九SHUJIU数九的第几天
三伏FU三伏的第几天
六曜LIUYAO2当天六曜2
二十八星宿XIU当天二十八星宿
二十八星宿XIUANIMAL当天二十八星宿动物
二十八星宿吉凶XIULUCK当天二十八星宿吉凶
二十八星宿歌诀XIUSONG当天二十八星宿歌诀
七曜ZHENG七曜,又称七政、七纬、七耀
四宫GONG四宫代表东南西北四个方位
四神兽SHOU四神兽对应四宫,分别是东青龙、南朱雀、西白虎、北玄武
彭祖百忌PENGZUGAN彭祖百忌天干
彭祖百忌PENGZUZHI彭祖百忌地支
吉神DAYPOSITIONXI吉神包括:喜神、阳贵神、阴贵神、福神、财神
吉神方位DAYPOSITIONYANGGUI各吉神及方位
未知DAYPOSITIONYINGUI未知
未知DAYPOSITIONFU未知
未知DAYPOSITIONCAI未知
本月胎神MONTHPOSITIONTAI本月胎神
本日胎神taishen本日胎神
日太岁方位DAYPOSITIONTAISUI日太岁方位
日冲DAYCHONGDESC日冲
日天干冲DAYCHONGGAN日无情之克的天干冲
日天干冲DAYCHONGGANTIE日有情之克的天干冲
日纳音DAYNAYIN日纳音
日所在旬DAYXUN日所在旬(以节交接当天起算)
日所在旬DAYXUNEXACT日所在旬(晚子时算第二天)
日空亡DAYXUNKONG日空亡(以节交接当天起算)
日空亡DAYXUNKONGEXACT日空亡(晚子时算第二天)
值星ZHIXING当日的值星。十二值星,也称建除十二神,中国民俗信仰中的十二位神明,分别为建、除、满、平、定、执、破、危、成、收、开、闭。
十二天神DAYTIANSHEN十二天神择日法,又名大黄道择日法,有十二位星神轮流值日,其名称及排列顺序依次为:青龙、明堂、天刑;朱雀、金贵、天德;白虎、玉堂、天牢;玄武、司命、勾陈。
天神道DAYTIANSHENTYPE当日的天神是黄道还是黑道
天神吉凶DAYTIANSHENLUCK当日的天神是吉还是凶
每日宜yi每日宜
每日忌ji每日忌
吉神宜趋DAYJISHEN吉神宜趋
凶神宜忌DAYXIONGSHA凶神宜忌
当天月相YUEXIANG当天月相
九星值日DAYNINESTAR九星值日
佛历日期FOTO佛历日期
道历日期TAO道历日期
相冲2xiangchong相冲2
季节jijie季节
年五行nianwuxing年五行
月五行yuewuxing月五行
日五行riwuxing日五行
星宿xingxiu星宿
六曜liuyao六曜
十二神shiershen十二神
儒略日rulueri儒略日
伊斯兰历yisilan伊斯兰历
彭祖百忌2pengzu彭祖百忌2
24节气描述jieqimsg24节气描述
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
    "id": "20260216",
    "ynian": "2026",
    "yyue": "2",
    "yri": "16",
    "WEEKJ": "1",
    "xingqi": "一",
    "YLLEAP": "FALSE",
    "jieri": "",
    "xingzuo": "水瓶座",
    "YLWEEKNOR": "8",
    "YLWEEKNOY": "8",
    "DAYSOFYEAR": "365",
    "DAYSINYEAR": "47",
    "YIYEAR": "2025",
    "nnian": "二零二五",
    "YIMONTH": "12",
    "nyue": "腊月",
    "YIDAY": "29",
    "nri": "廿九",
    "YIFESTIVAL": "除夕",
    "YEARGANZHI": "乙巳",
    "ganzhinian": "丙午",
    "YEARINGANZHIEXACT": "丙午",
    "ganzhiyue": "庚寅",
    "MONTHINGANZHIEXACT": "庚寅",
    "ganzhiri": "辛酉",
    "DAYINGANZHIEXACT": "辛酉",
    "DAYINGANZHIEXACT2": "辛酉",
    "DAYLU": "酉命互禄 辛命进禄",
    "DAYSHENGXIAO": "鸡",
    "JIEQICN": "立春第13天",
    "jieqi": "立春",
    "JIEQIDAYS": "13",
    "WUHOU": "立春 三候鱼陟负冰",
    "SHUJIU": "七九第4天",
    "FU": "",
    "LIUYAO2": "佛灭",
    "XIU": "危",
    "XIUANIMAL": "燕",
    "XIULUCK": "凶",
    "XIUSONG": "危星不可造高楼,自遭刑吊见血光,三年孩子遭水厄,后生出外永不还,埋葬若还逢此日,周年百日取高堂,三年两载一悲伤,开门放水到官堂。",
    "ZHENG": "月",
    "GONG": "北",
    "SHOU": "玄武",
    "PENGZUGAN": "辛不合酱主人不尝",
    "PENGZUZHI": "酉不会客醉坐颠狂",
    "DAYPOSITIONXI": "坤西南",
    "DAYPOSITIONYANGGUI": "艮东北",
    "DAYPOSITIONYINGUI": "离正南",
    "DAYPOSITIONFU": "西北西北",
    "DAYPOSITIONCAI": "震正东",
    "MONTHPOSITIONTAI": "占房床",
    "taishen": "厨灶门 外东南",
    "DAYPOSITIONTAISUI": "离正南",
    "DAYCHONGDESC": "(乙卯)兔",
    "DAYCHONGGAN": "乙",
    "DAYCHONGGANTIE": "甲",
    "DAYNAYIN": "石榴木",
    "DAYXUN": "甲寅",
    "DAYXUNEXACT": "甲寅",
    "DAYXUNKONG": "子丑",
    "DAYXUNKONGEXACT": "子丑",
    "ZHIXING": "危",
    "DAYTIANSHEN": "玄武",
    "DAYTIANSHENTYPE": "黑道",
    "DAYTIANSHENLUCK": "凶",
    "yi": "祭祀|斋醮|沐浴|开生坟|除服|成服|移柩|入殓|破土|安葬|合寿木",
    "ji": "开市|嫁娶|安床|会亲友|入宅|作灶|上梁",
    "DAYJISHEN": "母仓|月恩|三合|临日|天喜|天医|除神|鸣吠",
    "DAYXIONGSHA": "四耗|大煞|五离|勾陈",
    "YUEXIANG": "晓",
    "DAYNINESTAR": "四绿木天权",
    "FOTO": "二五六九年腊月廿九 (华严菩萨诞) (四天王巡行)",
    "TAO": "道歷四七二二年,天運乙巳年,庚寅月,辛酉日。腊月廿九日。",
    "xiangchong": "冲兔 (乙卯)煞东",
    "jijie": "春季",
    "nianwuxing": "天河水",
    "yuewuxing": "松柏木",
    "riwuxing": "石榴木",
    "xingxiu": "危宿(危月燕)",
    "liuyao": "佛灭",
    "shiershen": "成执位",
    "rulueri": "2461093.5",
    "yisilan": "1447年08月29日",
    "pengzu": "辛不合酱主人不尝,酉不宴客醉坐颠狂。",
    "jieqimsg": "立春 第13天 (距下一个节气“雨水”,还有2天)"
}
更新记录
2025-08-09 00:59:16 - 新增农历年,及数十种古历法星宿,天干,地支等。

2025-04-08 12:57:49 - 修复某些日期农历不正确的BUG。

2025-02-14 00:26:18 - 修复某些节日错乱BUG。

2025-01-30 03:30:03 - 修复关于除夕节日错乱BUG。PS:根据命里学说,干支年的起始日正规算法实际上是以每年立春为界,所以会出现蛇年的初始某些日期干支年却还是龙年(甲辰年)等类似情况。

2024-07-08 13:50:47 - 新增接口。

 时间操作-万年历[取当日信息]-2025-08-09 00:59:16

获取万年历当天各类信息,如农历日期,星期几,宜事务,忌事务,生肖,星座,节日,相冲,季节,五行,星宿,六曜,彭祖,节气等。

调用限制
单价/次 免费[无上限]
瞬时并发[单IP] 20
单日[所有用户之和] 999999999
1分钟并发[所有用户之和] 999999999
1小时并发[所有用户之和] 999999999
频次限制[注册用户] 10次/分钟|每日无上限
频次限制[钻石会员] 最高+1500次/分钟|每日无上限
频次限制[定制频次] 联系我们定制
调用方法
请求方式 GET/POST
返回格式 JSON
编码格式 UTF-8
调用信息
浏览量 20582
今日总计调用 5406
昨日总计调用 14447
历史总计调用 6327639
今日排名 14
总排名 17
自检信息

自检日志

自检启用状态 已启用
自检节点 上海
自检线路 彩钻接口线路
自检时间 2025-08-31 08:52:56
自检耗时 88 毫秒
自检状态 异常
历史自检成功数 178332 次
历史自检失败数 8118 次
历史自检成功率 95.65 %
今日自检成功数 0 次
今日自检失败数 146 次
今日自检成功率 0.00 %