Python的工作日判断库(含调休)——chinese_calendar

chinese_calendar 库使用场景

chinese_calendar 库主要用于处理中国农历和节假日相关的日期计算和判断。以下是一些常见的使用场景：

1. 判断日期是否为工作日：chinese_calendar 提供了 is_workday() 函数，可以判断指定日期是否为工作日，包括周末、法定节假日等。

2. 判断日期是否为节假日：chinese_calendar 提供了 is_holiday() 函数，可以判断指定日期是否为中国的法定节假日。

3. 获取节假日信息：chinese_calendar 提供了一系列函数用于获取节假日的详细信息，如 get_holiday_detail() 可以获取指定日期的节假日名称、类型和放假天数等信息。

4. 计算两个日期之间的工作日天数：chinese_calendar 提供了 workday_count() 函数，可以计算两个日期之间的工作日天数。

5. 星座计算：chinese_calendar 提供了 get_constellation() 函数，可以根据指定日期获取对应的星座信息。

总而言之，chinese_calendar 库在处理中国农历、节假日以及工作日相关的日期计算和判断时非常有用。它可以帮助程序开发人员在应用程序中方便地处理中国特定的日期逻辑。

法定的调休日也可以包含

在中国，法定调休日是指法定节假日因工作需要被调整的休息日。例如，如果国庆节假期前后的周末需要加班补偿工作，那么政府可以决定将周六或周日调整为工作日，而让国庆节时间保持不变。

对于法定调休日，chinese_calendar 库中的 is_workday() 函数会将其视为工作日。这是因为，虽然法定调休日本身是休息日，但在调整后成为了工作日，人们需要按照工作日的要求进行工作和生活。因此，is_workday() 函数会将其视为工作日。

以下是一个判断法定调休日的示例代码：

import chinese_calendar as calendar
from datetime import date

# 判断法定调休日是否为工作日
is_workday = calendar.is_workday(date(2022, 10, 8)) # 假设这是国庆节调休后的工作日
if is_workday:
    print("法定调休日是工作日")
else:
    print("法定调休日是休息日")

在上述代码中，我们使用 date() 函数创建了一个日期对象，表示国庆调休后的第一天工作日。然后使用 is_workday() 函数判断该日期是否为工作日，并输出相应的结果。

需要注意的是，在使用 is_workday() 函数判断法定调休日时，需要将其视为工作日。如果你需要根据具体情况进行判断，请结合实际情况进行相应的调整。
示例

import chinese_calendar as calendar
from datetime import date, timedelta

# 判断当天是否为工作日
print(date.today())
print(type(date.today()))
is_workday = calendar.is_workday(date.today())
print(f"今天是否为工作日：{is_workday}")
# 获取昨天的日期
yesterday = date.today() - timedelta(days=1)
is_workday = calendar.is_workday(yesterday)
print(f"昨天是否为工作日：{is_workday}")
# 获取前天的日期
before_yesterday = date.today() - timedelta(days=2)
is_workday = calendar.is_workday(before_yesterday)
print(f"前天是否为工作日：{is_workday}")


from datetime import datetime
# 输入特定字符串的日期
date_str = "2024-02-04"

# 将字符串转换为日期对象
date_obj = datetime.strptime(date_str, "%Y-%m-%d").date()

# 判断日期是否为工作日
is_workday = calendar.is_workday(date_obj)
if is_workday:
    print(f"{date_obj} 是工作日")
else:
    print(f"{date_obj} 不是工作日")

在上述代码中，我们导入了 chinese_calendar 库和 date 类，使用 is_workday() 函数判断当前日期 date.today() 是否为工作日，并将结果打印出来。

需要注意的是，使用前要确保已经安装了 chinese_calendar 库，可以通过运行 pip install chinese_calendar 命令进行安装。

调休的工作日通常也被视为工作日，并不属于节假日。因此，在判断日期是否为工作日时，调休的工作日也应该被算作工作日。

举个例子，在国庆节放假期间，如果调休周末的话，那么调休后的工作日就被视为正常工作日，而非休息日。

在使用 chinese_calendar 库中的 is_workday() 函数进行判断时，会考虑调休情况，将调休后的工作日当做正常的工作日。

如何安装

pip 是 Python 的包管理器，用于安装、升级和管理第三方库。

要在命令行中使用 pip 安装 Python 包，可以执行以下命令：

python -m pip install package_name

其中，package_name 是你要安装的包的名称。

例如，如果要安装 numpy 库，可以执行以下命令：

python -m pip install numpy

这将使用 pip 安装最新版本的 numpy 库。

需要注意的是，你需要确保 Python 已经正确安装并设置好环境变量，在命令行中可以直接使用 python 命令。