二十四节气 API

查询某年二十四节气的交节日期与精确时刻，以及当前节气和距下一个节气的天数（天文算法本地计算）

数据来源：本地计算（太阳视黄经天文算法，北京时间）

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

某年的二十四节气日期与交节时刻

GET /api/jieqi

请求参数

  • year：年份 1900–2100，默认今年（北京时间），示例 2026

返回字段

  • year（number）：年份
  • count（number）：节气个数，固定为 24
  • terms（array）：全年 24 个节气，按日期先后排列（小寒在 1 月初，冬至在 12 月下旬）
  • terms[].index（number）：在一年中的序号 1–24（1=小寒，24=冬至）
  • terms[].name（string）：节气名称，如 立春
  • terms[].date（string）：交节日期 YYYY-MM-DD（北京时间）
  • terms[].time（string）：交节时刻 YYYY-MM-DD HH:mm（北京时间 UTC+8，天文算法计算，误差约 1 分钟）
  • terms[].longitude（number）：交节时的太阳视黄经（度），如 立春 315、春分 0、夏至 90
  • terms[].season（string）：所属季节：春/夏/秋/冬（按四立划分）
  • terms[].desc（string）：节气简介

当前节气与距下一个节气的天数

GET /api/jieqi/next

请求参数

  • date：日期 YYYY-MM-DD，默认今天（北京时间），示例 2026-09-27

返回字段

  • date（string）：查询日期 YYYY-MM-DD（北京时间）
  • today（string|null）：当天交节的节气名称；当天不是节气时为 null
  • current（object）：当前所处的节气（当天或之前最近一次交节的节气）
  • current.index（number）：在一年中的序号 1–24（1=小寒，24=冬至）
  • current.name（string）：节气名称，如 立春
  • current.date（string）：交节日期 YYYY-MM-DD（北京时间）
  • current.time（string）：交节时刻 YYYY-MM-DD HH:mm（北京时间 UTC+8，天文算法计算，误差约 1 分钟）
  • current.longitude（number）：交节时的太阳视黄经（度），如 立春 315、春分 0、夏至 90
  • current.season（string）：所属季节：春/夏/秋/冬（按四立划分）
  • current.desc（string）：节气简介
  • current.daysSince（number）：距该节气交节日已过去的天数（交节当天为 0）
  • next（object）：下一个节气（交节日期晚于查询日期）
  • next.index（number）：在一年中的序号 1–24（1=小寒，24=冬至）
  • next.name（string）：节气名称，如 立春
  • next.date（string）：交节日期 YYYY-MM-DD（北京时间）
  • next.time（string）：交节时刻 YYYY-MM-DD HH:mm（北京时间 UTC+8，天文算法计算，误差约 1 分钟）
  • next.longitude（number）：交节时的太阳视黄经（度），如 立春 315、春分 0、夏至 90
  • next.season（string）：所属季节：春/夏/秋/冬（按四立划分）
  • next.desc（string）：节气简介
  • next.days（number）：距下一个节气还有几天
  • text（string）：一句话中文描述，适合机器人直接回复，如 当前节气：秋分（第 5 天），距离寒露还有 11 天（2026-10-08）