[DEMO] 农历与二十四节气

按日期查询农历及二十四节气信息
支持 1901-01-01 至 2100-02-08；超出可计算范围明确失败，不承诺任意日期。date 必须传入，显式空值使用北京时间当天。下一节气的月日可能属于次年；全年节气从立春起排列，不新增时间或城市参数。
按公历日期查询对应农历年月日，便于制作日期对照。
返回中文农历日期，可用于中文日历和日期标签。
闰月在数字农历日期与中文日期中分别标明，便于区分同名月份。
返回日期对应的干支与生肖文字，便于展示农历背景信息。
查询指定日期当天是否为节气，没有节气时返回“无”。
返回指定日期之后的下一节气及月日，便于日历提示。
年末查询可返回次年的下一节气，适合跨年日历衔接。
一次返回查询公历年内 24 项节气及月日，便于制作年度节气表。
农历与节气均以同一个查询日期计算，便于统一展示。
支持有效范围内的历史与未来日期，便于整理活动日期资料。
显式传入空日期时兼容查询北京时间当天，适合当日日历展示。
提供春节日期的公开完整样例，可对照输入与农历、节气结果。
参数错误 501/HTTP 400；依赖失败 901/HTTP 503。
固定 date=20260217 的完整样例，无需凭据。

当前接口契约

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

正常响应

HTTP 200，application/json。

字段	类型	说明
DataStatus	object
DataStatus.StatusCode	integer
DataStatus.RequestParameter	string	真实可读的 date 参数，不含凭据。
DataStatus.StatusDescription	string
DataStatus.ResponseDateTime	string
DataStatus.DataTotalCount	integer
Data	object

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功	HTTP 200
501	参数错误或凭据冲突	HTTP 400
504	APPKEY 缺失或无效	HTTP 401
901	计算依赖失败或超时	HTTP 503

返回响应

🟢200成功

application/json

成功业务码 100，返回一个农历与节气对象。

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "date=20260217",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-10-11 22:27:36.757",
    "DataTotalCount": 1
  },
  "Data": {
    "LunarDate": "2026-1-1",
    "LunarDateChinese": "二零二六 丙午 马年 正月大初一",
    "SolarTermNext": "雨水:2-18",
    "SolarTermThisYear": "立春:2-4 雨水:2-18 惊蛰:3-5 春分:3-20 清明:4-5 谷雨:4-20 立夏:5-5 小满:5-21 芒种:6-5 夏至:6-21 小暑:7-7 大暑:7-23 立秋:8-7 处暑:8-23 白露:9-7 秋分:9-23 寒露:10-8 霜降:10-23 立冬:11-7 小雪:11-22 大雪:12-7 冬至:12-22 小寒:1-5 大寒:1-20",
    "SolarTermToday": "无"
  }
}

🟠400参数错误或凭据冲突，业务码 501；公共鉴权与限流保留既有契约。

🟠401APPKEY 缺失或无效，业务码 504；公共鉴权与限流保留既有契约。

🔴503计算依赖失败或超时，业务码 901；公共鉴权与限流保留既有契约。

当前接口契约

正常响应

业务状态说明

请求参数

请求示例代码

返回响应

[DEMO] 农历与二十四节气

当前接口契约#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

正常响应

业务状态说明