npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

chinese-days

v2.0.0

Published

中国节假日、调休日、工作日、24节气查询,农历阳历互转,支持 TS、CommonJS、UMD 模块化使用,提供 ics 日历格式,可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端订阅。

Readme

中国节假日

NPM Version GitHub License README

本项目提供了一系列用于查询中国节假日、调休日、工作日、24节气、以及农历阳历互转的函数,提供 JSON 文件,此外还支持 iCal 文件订阅节假日,可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端订阅。

自动化

已集成 AI 提取官方公告并判断调休日期、程序自动校验和创建 PR 的流程,无需人工填写调休规则。只新增已收录最大年份的下一年,已有年份直接跳过;校验失败会自动反馈给 AI 重试,PR 实际变化时才发送邮件。

正式节假日 PR 审核合并后会自动递增 patch 版本、创建标签并发布 npm;测试 PR 不触发发布。

配置格式保持 .r()、.w()、.i(),详细流程及自动校验规则见贡献指南。

参考PR:#31 自动更新 2025 年假期配置

文档

查看文档, 请访问 chinese-days.yaavi.me.

每日会执行 Action 检查下一年的官方公告,生成新年份提案并发送邮件提醒审核,已有年份保持不变。

  • 节假日:支持 2004年 至 2026年,包括 2020年 的春节延长
  • 24节气:支持 1900年 至 2100年。
  • 农历日:支持 1900年 至 2100年。

非 JS 语言

如果你不使用 JS 或 TS 开发项目,本项目提供了中国节假日的 JSON 文件,通过链接 chinese-days.json 可以直接引用;如果需要按年份单独的 JSON 文件,也可以通过链接 years/2025.json 直接引用,支持 2004 及之后的年份。

比如在 Java 中使用,可以参考 Warnier-zhang/java-chinese-days,仅用于查询中国节假日、调休日、工作日;

日历订阅

在 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端中,可以设置订阅地址:https://cdn.jsdelivr.net/npm/chinese-days/dist/holidays.ics 来获取日历订阅。

For English: https://cdn.jsdelivr.net/npm/chinese-days/dist/holidays.en.ics

订阅的日历包含近三年的节假日和调休日。

如果需要按年份单独的 ics 文件,也可以通过链接 https://cdn.jsdelivr.net/npm/chinese-days/dist/years/2025.ics 直接引用,英文版本为 https://cdn.jsdelivr.net/npm/chinese-days/dist/years/2025.en.ics,支持 2004 及之后的年份。

贡献代码

修改农历或节气数据后,运行 npm run check:calendars 逐日核对紫金山天文台和香港天文台历表。核对范围、港表已知差异及基准更新方法

  1. Fork + Clone 项目到本地;
  2. 节假日: 修改 节假日定义;
  3. 农历定义: 修改 农历定义;
  4. 其他修改...;
  5. 提交PR。

致谢

  1. 农历数据来自于 Bigkoo/Android-PickerView 项目。
  2. 中国节假日数据生成参考了 Python 版本的 LKI/chinese-calendar 项目。
  3. 感谢阮一峰大佬的推荐。