公历日期转农历日期API接口文档 GET / POST 生活服务

用于将公历日期转换为农历日期,支持1944年至2051年的日期范围。

请求 GET / POST返回 application/json0.1 积分 / 次上线 2026-09-24 14:57:41

用于将公历日期转换为农历日期,支持1944年至2051年的日期范围。

0.1 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=solar2lunar
方法
GET / POST
分类
生活服务
计费
0.1 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者

公历日期转农历日期接口信息

接口地址:
https://api.souxiaocha.com/apis/gateway?api=solar2lunar
请求方式:
GET / POST
返回格式:
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=solar2lunar

apikey=你的API密钥&date=请填写date

GET 参数放在查询字符串中。参数值请替换为实际有效值。

公历日期转农历日期请求参数

参数名类型必填说明示例
datestring公历日期,格式为YYYY-MM-DD。不传则默认使用当天日期

详细文档

公历日期转农历日期 API 接口文档

接口描述

用于将公历日期转换为农历日期,支持1944年至2051年的日期范围。

功能特性

  • 用于将公历日期转换为农历日期,支持1944年至2051年的日期范围。
  • 返回 JSON 结构化数据,便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计,支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=solar2lunar

请求方式

GET / POST(业务参数 GET 通过 URL 传递,POST 支持表单或 JSON)

鉴权方式

调用需携带平台密钥(用户中心「令牌管理」获取,SK- 开头):

  • URL 参数:key=SK-你的密钥
  • 或请求头:X-API-Key: SK-你的密钥

请求参数

参数名 类型 必填 描述
date string 公历日期,格式为YYYY-MM-DD。不传则默认使用当天日期

请求参数 (JSON格式)

[
  {"name": "date", "type": "string", "required": false, "description": "公历日期,格式为YYYY-MM-DD。不传则默认使用当天日期"}
]

响应格式

JSON 格式响应

返回参数说明

参数名 类型 说明
success boolean 请求是否成功
data.solar_date string 原始公历日期
data.lunar_date.year integer 农历年份(数字)
data.lunar_date.year_text string 农历年份(中文)
data.lunar_date.month integer 农历月份(数字)
data.lunar_date.month_text string 农历月份(中文)
data.lunar_date.day integer 农历日期(数字)
data.lunar_date.day_text string 农历日期(中文)
data.lunar_date.full_text string 完整农历日期(带"农历"前缀)
data.lunar_date.display string 完整农历日期(不带前缀)
generated_at string 响应生成时间

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=solar2lunar?key=SK-你的密钥&date=2026-09-24"

错误响应

平台级错误(errcode):11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcodemsg 判断。

注意事项

  • 本接口为平台代理的聚合数据服务,数据与稳定性以上游服务为准
  • 涉及命理、测算类内容(如有)仅供娱乐参考,不构成任何现实建议
  • 请合理控制调用频率,避免高频恶意调用触发风控
  • 密钥请妥善保管,勿在公开代码或前端页面中暴露

开发时间

2026-09-24