计算当月已过去的交易日数量

2026-01-30 00:00:00 作者:花韻仙語

本文介绍如何使用 python 快速计算从当月第一天到今天(含或不含今日)之间经过的交易日(周一至周五)天数,涵盖基于 numpy 的高效方案与纯 python 的兼容性方案,并附带代码示例与关键注意事项。

在金融、财务或任务调度等场景中,常需统计“本月已过多少个工作日”(即排除周末和法定节假日的自然日),而非简单的日历天数。例如,2025年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(以 2025-02-12 为例)

⚠️ 注意:busday_count(start, end) 默认左闭右开区间(即包含 start,不包含 end)。因此上述代码统计的是 2025-02-01

至 2025-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 版本则适用于轻量级或受限环境,二者均可根据实际需求灵活选用。

猜你喜欢

联络方式:

400 9058 355

邮箱:8955556@qq.com

Q Q:8955556

微信二维码
在线咨询 拨打电话

电话

400 9058 355

微信二维码

微信二维码