免费农历转换 API

阳历 ↔ 农历(干支年/月/日)免费转换服务,回馈开源社区。数据范围 1900–2100

单日转换

GET https://api.27.gs.cn/lunar?y=2026&m=8&d=15
{"solar":"2026-8-15","lunar_date":"丙午七月初三"}

批量转换

POST https://api.27.gs.cn/lunar/batch
Content-Type: application/json
["2026-8-15","2026-1-1"]
{"2026-8-15":"丙午七月初三","2026-1-1":"乙巳冬月十三"}

参数与限制

说明
y / m / d公历年/月/日,整数;y 限 1900–2100
批量上限单次 ≤ 500 条
返回格式JSON;非法参数返回 400
缓存结果恒定,建议客户端缓存

浏览器调用示例(CORS 已开放)

fetch('https://api.27.gs.cn/lunar?y=2026&m=8&d=15')
  .then(r => r.json())
  .then(j => console.log(j.lunar_date)); // 丙午七月初三

技术栈与鸣谢

换算算法基于开源库 solarlunar(作者 yize,ISC 协议,GitHub 仓库)。

本站为佩玉廿七(27.GS.CN)公益提供 · 请勿滥用,感谢配合。