覆盖 1900 至 2100 年的公历农历互转、法定节假日、调休安排、二十四节气、生肖属相与每日宜忌查询，适用于日历应用、排班系统、黄历工具、社交提醒等场景。
万年历 API 通过标准 HTTP GET 请求返回结构化 JSON 数据，支持单日查询与整月查询两种模式。返回字段涵盖公历日期、农历日期（月/日）、生肖、节气、法定节假日名称、宜忌等信息。节假日数据在国务院公告后 24 小时内同步更新，接口全程 HTTPS 加密传输，毫秒级响应，适用于日历组件、智能排班、文化内容等各类应用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥，在控制台「应用管理」中创建应用后获取。 |
| date | string | 是 | 查询日期，格式 yyyy-MM-dd，如「2026-07-25」；type=month 时只需 yyyy-MM。 |
| type | string | 否 | 查询模式：day=单日详情（默认）、month=整月概览。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示请求成功，其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.date | string | 公历日期，格式 yyyy-MM-dd。 |
| data.lunar | string | 农历年份干支纪年，如丙午年。 |
| data.lunar_month | string | 农历月份，如六月。 |
| data.lunar_day | string | 农历日，如十一。 |
| data.zodiac | string | 生肖属相，如马。 |
| data.term | string | 节气名称（当日有节气时返回），如大暑。 |
| data.holiday | string | 法定节假日名称（当日是节假日时返回）。 |
| data.yi | string | 今日宜，如祭祀、出行、纳财。 |
| data.ji | string | 今日忌，如动土、安葬。 |
| data.update_time | string | 数据更新时间，格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"date": "2026-07-25",
"lunar": "丙午年",
"lunar_month": "六月",
"lunar_day": "十一",
"zodiac": "马",
"term": "",
"holiday": "",
"yi": "祭祀 出行 纳财 开市",
"ji": "动土 安葬 破土",
"update_time": "2026-07-25 00:00:00"
}
}