Skip to main content

中国节假日

Package License README

判断某年某月某一天是不是工作日/节假日。 支持 2004年 至 2027年,包括 2020年 的春节延长。

安装

pip install chinesecalendar

升级

pip install -U chinesecalendar

由于次年的节假日安排,取决于国务院发布的日程。 所以本项目一般会在国务院更新以后,发布新的版本。 按照以往的经验,一般是每年的 11月 前后发布新版本。

样例

import datetime

# 判断 2018年4月30号 是不是节假日
from chinese_calendar import is_holiday, is_workday
april_last = datetime.date(2018, 4, 30)
assert is_workday(april_last) is False
assert is_holiday(april_last) is True

# 或者在判断的同时,获取节日名
import chinese_calendar as calendar  # 也可以这样 import
on_holiday, holiday_name = calendar.get_holiday_detail(april_last)
assert on_holiday is True
assert holiday_name == calendar.Holiday.labour_day.value

# 还能判断法定节假日是不是调休
import chinese_calendar
assert chinese_calendar.is_in_lieu(datetime.date(2006, 2, 1)) is False
assert chinese_calendar.is_in_lieu(datetime.date(2006, 2, 2)) is True

其它语言

假如你没法使用Python, 你也可以转译现成的常量文件来获取最全的节假日安排表。

贡献代码

  1. Fork + Clone 项目到本地,安装 uv 后执行 make install
  2. 修改节假日定义
  3. 执行 make fmt,它会调用脚本自动生成常量文件并格式化代码
  4. 执行 make test 确认检查和测试都通过
  5. 提交PR

Metadata

Release files for chinese-calendar 1.12.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chinese-calendar 1.12.1
File Size Uploaded Provenance Actions
chinese_calendar-1.12.1.tar.gz 18.1 kB Without provenance Details for chinese_calendar-1.12.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for chinese-calendar 1.12.1
File Interpreter ABI Platform Actions
chinese_calendar-1.12.1-py3-none-any.whl Python 3 none any Details for chinese_calendar-1.12.1-py3-none-any.whl

Total release size: 30.5 kB

Release files / chinese_calendar-1.12.1.tar.gz

Download URL chinese_calendar-1.12.1.tar.gz
Size 18.1 kB
Tags Source
SHA-256 checksum
How to use checksums
9355e6398cd360100fab75262971dd28e1ca61cac994ccb3768cfb84b77466fe
BLAKE2b-256 checksum
How to use checksums
4d7bf5f66c5d2d01610fc23a4619923d59d94523ef5c70b67c1aadb9234de05a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release files / chinese_calendar-1.12.1-py3-none-any.whl

Download URL chinese_calendar-1.12.1-py3-none-any.whl
Size 12.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
201168423c879a9584b5cd13054f039a2ff34dad9cf5f822dd1133379983a79e
BLAKE2b-256 checksum
How to use checksums
e8c7152a1cc368ff364cdf7917198bd78dcd56267a5b1dc2cf44d2dbd752e971
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Security for chinese-calendar 1.12.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page