查询指定日期、月份或年份的万年历与节假日信息。
这个接口支持三种查询方式：按天（date）、按月（month）和按年（year）。调用时三者选一个传入即可。
如果你只关心某一类事件，可以通过 holiday_type 进行筛选，例如只看法定休假/调休、公历节日、农历节日或节气。
在 date 模式下，传 include_nearby=true 可以额外返回该日期前后最近的节日；返回数量由 nearby_limit 控制，默认 7，最大 30。
如果你只想保留今天和之后的节日，可以再传 exclude_past=true 过滤已经过去的节日。
date按天查询时填写这个参数，例如查某一天。格式：YYYY-MM-DD。和 month、year 三选一。
month按月查询时填写这个参数，例如查某个月。格式：YYYY-MM。和 date、year 三选一。
year按年查询时填写这个参数，例如查某一年。格式：YYYY。和 date、month 三选一。
timezone时区名称，默认 Asia/Shanghai。
holiday_type节日筛选类型，默认 all。
include_nearby是否返回前后最近节日，仅 date 模式生效，默认 false。month/year 模式会忽略此参数。
nearby_limit返回最近节日数量限制，默认 7，最大 30。仅 date 模式 + include_nearby=true 生效。
exclude_past传 true 时，会过滤今天之前已经过去的节日。默认 false。
查询成功，返回指定范围的万年历与节假日信息。
请求参数错误。常见原因：
date、month、year 未传或同时传入多个date 必须为 YYYY-MM-DD、month 必须为 YYYY-MM、year 必须为 YYYYholiday_type 非法timezone 非法选择你的语言查看调用示例
curl 'https://uapis.cn/api/v1/misc/holiday-calendar'查询节假日与万年历API 遵循我们的标准使用政策。具体的调用频率限制和参数要求请参考上方的接口文档。如有特殊需求，请与我们联系。
无需注册即可使用访客积分调用接口。如果您需要更多积分或想要管理自己的调用记录，可以免费注册账号。注册后您将获得更多免费积分，并可以在控制台查看详细的使用情况。
我们的API基于标准的HTTP协议和RESTful设计，理论上支持任何可以发送网络请求的编程语言，包括但不限于 JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C# 等。它们非常适合用于Web开发、移动APP后端、小程序云函数、自动化脚本等各种开发场景。
节假日/万年历 API 已上线，支持按 date、month、year 三种模式查询，三者互斥。
你可以通过 holiday_type 仅查看法定休假日、调休上班日、公历节日、农历节日或节气。
在 date 模式下可开启 include_nearby=true，返回前后最近 N 个节日，nearby_limit 默认 7，最大 30。
返回结构包含 summary、days、holidays 和 nearby，适合日历、排班、节日提醒等场景直接接入。