
本文介绍如何使用 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
综上,numpy.busday_count 是最简、最健壮的首选方案;而纯 Python 版本则适用于轻量级或受限环境,二者均可根据实际需求灵活选用。










