本文介绍如何使用 python 快速计算从当月第一天到今天（含或不含今日）之间经过的交易日（周一至周五）天数，涵盖基于 numpy 的高效方案与纯 python 的兼容性方案，并附带代码示例与关键注意事项。
在金融、财务或任务调度等场景中，常需统计“本月已过多少个工作日”（即排除周末和法定节假日的自然日），而非简单的日历天数。例如，2024年2月12日（星期一）时，2月1日至12日期间实际有7个交易日（2月1日–2日、5日–9日），若包含当日则为8个。
✅ 推荐方案：使用 numpy.busday_count
numpy.busday_count() 是专为工作日计算设计的高效函数，支持自定义周内工作日（默认周一至周五），且底层用 C 实现，性能优异：
from datetime import datetime import numpy as np today = datetime.today().date() first_day = today.replace(day=1) business_days = np.busday_count(first_day, today) # 不含 today # 若需包含今日，可改为：np.busday_count(first_day, today + timedelta(days=1)) print(business_days) # 输出：7（以 2024-02-12 为例）
⚠️ 注意：busday_count(start, end) 默认左闭右开区间（即包含 start，不包含 end）。因此上述代码统计的是 2024-02-01 至 2024-02-12 之间的完整交易日数量（即 1 日计入，12 日不计入），结果为 7。如需包含今日，应将 end 设为 today + timedelta(days=1)。
? 纯 Python 方案（无依赖）
若项目禁止引入 NumPy，可用标准库实现逻辑等效的计数（注意：此方法不自动排除法定节假日）：
from datetime import datetime, timedelta
today = datetime.today().date()
first_day = today.replace(day=1)
delta_days = (today - first_day).days
# 统计 [first_day, today) 区间内 weekday() < 5 的天数（即周一至周五）
business_days = sum(
(first_day + timedelta(days=n)).weekday() < 5
for n in range(delta_days)
)
print(business_days) # 同样输出：7该方案通过遍历每日并调用 .weekday()（返回 0=周一, 6=周日）判断是否为工作日，简洁可靠，但时间复杂度为 O(n)，对跨月长周期略慢（通常月份最多31天，影响可忽略）。
? 重要说明
- 以上所有方法均不处理法定节假日。如需支持节假日（如中国春节、国庆调休），建议结合 holidays 库或自定义假期列表，对日期逐个过滤；
- datetime.date.weekday() 返回值范围是 [0, 6]，其中 0–4 对应周一至周五，5–6 为周六、周日；
- 若需动态指定起止日期（非仅“本月首日→今日”），只需替换 first_day 和 today 变量即可复用逻辑；
- 在生产环境中，建议将核心逻辑封装为函数，并添加类型提示与错误处理（如确保 start <= end）。
综上，numpy.busday_count 是最简、最健壮的首选方案；而纯 Python 版本则适用于轻量级或受限环境，二者均可根据实际需求灵活选用。
