Calendar - 万年历查询

🗓️ 万年历黄历节假日一键查询

接入极速数据万年历API,支持公农历转换、星座生肖、黄历宜忌及节假日查询,数据丰富但依赖第三方服务稳定性。

收藏
4.3k
安装
1.1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

极速数据万年历(Jisu Calendar)是一个基于第三方API的日历查询技能,主要提供两大功能:

1. 万年历查询(`/calendar/query`)

  • 输入公历或农历日期,返回详尽的历法信息
  • 支持阴阳历双向转换(通过 islunar 参数控制)
  • 输出包含:公历日期与星期、农历年月日、干支纪年、生肖、星座
  • 完整黄历信息:宜忌事项、吉神凶神、五行冲煞、胎神方位、财神喜神方位等

2. 节假日查询(`/calendar/holiday`)

  • 查询法定节假日放假安排与调休说明
  • 返回格式为日期-说明的键值对

技术实现

  • 调用本地 Python3 脚本:skills/calendar/calendar.py
  • 需配置环境变量 JISU_API_KEY(从极速数据官网申请)
  • 请求为 JSON 格式,支持 dateislunarislunarmonth 等参数

显著优点

1. 数据维度全面:单接口返回公历、农历、星座、生肖、干支、黄历宜忌等十余类信息,满足传统历法查询的一站式需求
2. 黄历细节丰富:包含专业级黄历字段如吉神凶神、五行、冲煞、胎神、诸神方位等,适合有择吉需求的用户

3. 节假日官方口径:放假安排基于国务院公布数据,可用于排班、出行规划

4. 阴阳历互转灵活:通过 islunar 参数可实现农历查公历、公历查农历

潜在缺点与局限性

1. 第三方依赖风险:数据完全依赖极速数据平台,存在服务中断、接口变更、数据更新延迟等风险
2. API 成本约束:免费额度有限(通常需付费或受调用次数限制),高频使用可能触发 104/106 错误码

3. 黄历权威性存疑:传统黄历内容属于民俗文化范畴,缺乏科学验证,不同地区/流派宜忌标准可能冲突

4. 节假日数据时效性:需等待官方公布次年安排,年初可能存在数据空缺

5. 无本地化缓存:每次查询实时联网,离线不可用,响应速度受网络影响

适合人群

  • 需要快速查询农历、黄历宜忌的个人用户
  • 开发日历、提醒、择吉类应用的开发者(作为数据源)
  • 关注法定节假日安排用于行程规划的上班族
  • 对传统历法文化感兴趣的研究者

常规风险

| 风险类型 | 说明 |
|---------|------|
| 服务可用性 | 第三方API可能宕机、限流或停止服务 |
| 数据准确性 | 黄历内容属民俗传统,非科学标准;节假日以官方最终公布为准 |
| API密钥泄露 | `JISU_API_KEY` 需妥善保管,硬编码或日志泄露可能导致额度被盗用 |
| 隐私暴露 | 查询日期虽非敏感信息,但请求日志可能被第三方记录 |
| 依赖维护 | API文档变更或版本升级可能导致技能失效 |

Calendar - 万年历查询 内容

手动下载zip · 4.1 kB
calendar.pytext/plain
请选择文件