农历与二十四节气

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

当前接口契约

接口详情：https://www.gugudata.com/api/details/lunarcalendar

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	开发者中心分配的 APPKEY；保留 Query、Header 和 Bearer 鉴权。此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
date	string	是	无	必须传入，格式 yyyyMMdd，支持 19010101–21000208。显式空值或空白使用北京时间当天，无固定默认日期。

正常响应字段

字段	类型	说明
DataStatus.StatusCode	integer	成功业务码为 100；错误码见说明。
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	integer	成功返回一个农历与节气对象，值为 1。
Data.LunarDate	string	农历年-月-日；闰月保留末尾 -闰，如 2023-2-1-闰。
Data.LunarDateChinese	string	包含中文农历年、干支生肖文字及中文月日。
Data.SolarTermNext	string	指定日期之后的下一节气，格式名称:月-日；年末可能指向次年，结果不含年份。
Data.SolarTermThisYear	string	查询公历年内 24 项节气，从立春起排列，最后两项为小寒和大寒，不表示从请求日开始排序。
Data.SolarTermToday	string	指定日期的节气名称；当天没有节气时返回无，不包含日期。
DataStatus.RequestParameter	string	实际 date 输入，不包含凭据。

业务状态说明

业务状态码	业务状态码解释	备注
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.722",
    "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）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明