Calendar - 万年历查询

🗓️ 公历农历一键查,黄历宜忌全掌握

基于极速数据万年历 API,提供公历农历转换、黄历宜忌、节假日查询,需申请 API Key 使用。

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

使用说明

极速数据万年历技能评估

核心用法

该技能基于极速数据(jisuapi.com)的万年历 API,提供两类核心功能:

1. 万年历查询/calendar/query

  • 支持公历与农历双向转换
  • 返回信息包括:公历日期、星期、农历日期、干支、生肖、星座
  • 黄历详情:宜忌事项、吉神凶神、胎神、五行、冲煞、岁次等
  • 请求参数支持 islunar 标记按农历查询,支持闰月识别

2. 节假日查询/calendar/holiday

  • 查询中国法定节假日安排
  • 返回放假日期、调休说明等文本信息

显著优点

  • 信息维度丰富:单次查询即可获取历法、民俗、节气、黄历等多层信息
  • 中文场景适配:专为中文用户设计,农历、干支、生肖等传统文化要素完整
  • API 稳定性:极速数据为国内老牌数据服务商,接口文档规范
  • 阴阳历互转:支持双向查询,满足传统节日起源追溯需求

潜在缺点与局限性

  • 外部依赖重:完全依赖极速数据 API,网络中断或服务变更将导致功能失效
  • API Key 门槛:需单独注册申请,增加了使用成本
  • 黄历内容性质:宜忌、吉凶等属于民俗文化范畴,无科学依据,可能引发误解
  • 节假日覆盖有限:仅覆盖中国大陆法定节假日,不含其他地区或民俗节日
  • 无历史数据深度:未说明是否支持 1900 年前或 2100 年后的历法计算

适合人群

  • 需要快速查询农历转换的开发者或普通用户
  • 构建日程管理、提醒类应用时需要节假日数据的场景
  • 对传统黄历文化感兴趣,用于参考性查询(非决策依据)

常规风险

| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | `JISU_API_KEY` 需妥善保管,硬编码或日志泄露将导致配额被盗用 |
| 服务可用性 | 第三方服务可能因维护、停用或网络问题中断 |
| 配额限制 | 免费/付费账户均有调用次数上限,高频场景需预估成本 |
| 数据准确性 | 黄历内容属于民俗传统,不宜用于医疗、法律等重大决策 |
| 隐私暴露 | 查询日期本身无隐私风险,但结合用户行为模式可能推断个人习惯 |

Calendar - 万年历查询 内容

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