公开的农历转换 API

西历 → 农历（干支年/月/日）免鉴权转换服务 · 数据范围 1900–2100

阳历转农历干支纪年的公开接口，无需鉴权，结果恒定，建议客户端缓存。

接入地址 https://d01.27.gs.cn · CORS 已开放（Access-Control-Allow-Origin: *），浏览器可直接调用。

接口

GET/lunar

单日转换。参数 y m d 为公历年/月/日整数。

curl "https://d01.27.gs.cn/lunar?y=2026&m=8&d=19"
{"solar":"2026-8-19","lunar_date":"丙午七月初七"}
POST/lunar/batch

批量转换。请求体为日期字符串数组，单次 ≤ 500 条。

curl -X POST https://d01.27.gs.cn/lunar/batch \
     -H "Content-Type: application/json" \
     -d '["2001-7-01","2024-6-27"]'
{"2001-7-01":"辛巳五月十一","2024-6-27":"甲辰五月廿二"}

参数与限制

项说明
y / m / d公历年/月/日，整数；y 限 1900–2100
批量上限单次 ≤ 500 条
调用频率单 IP 每分钟 60 次、每日 10,000 次；超限返回 429
返回格式JSON（UTF-8）
错误码400 参数错误 · 429 频率超限 · 500 内部错误
缓存结果恒定，建议客户端缓存

浏览器调用示例

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

换算算法基于开源库 solarlunar（作者 yize，ISC 协议，GitHub 仓库）。

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

本站自 2026 年 8 月 15 日（丙午七月初三）上线 · 已稳定运行 0 天