pandas.bdate_range无法处理法定节假日,holidays参数已弃用;应使用pd.date_range生成日期序列,再结合holidays库(如holidays-cn)布尔索引过滤。

用 pandas.bdate_range 生成基础工作日序列,但默认只排除周末
它本质是 business day range,底层只按周一到周五过滤,holidays 参数不生效——这是最常被误解的一点。直接写 pandas.bdate_range(start='2024-01-01', end='2024-01-31', holidays=['2024-01-28']) 不会跳过 1 月 28 日,因为 bdate_range 的 holidays 参数在 pandas 2.0+ 已被弃用且无实际作用。
所以不能依赖它处理法定节假日,只能先生成标准工作日,再手动剔除。
用 pandas.date_range + holidays 库做精准过滤
推荐组合:用 pandas.date_range 生成完整日期序列,再用 Python holidays 库(如 holidays-cn 或官方 holidays)判断是否为节假日,最后布尔索引过滤。
实操建议:
- 安装
holidays-cn(支持中国全部法定节假日和调休):pip install holidays-cn - 构造
holidays.CN()实例时注意传入年份范围,否则部分跨年节假日(如春节)可能漏判 - 对
date_range的每个date,用date in cn_holidays判断,比调用cn_holidays.get(date)更快且安全 - 避免用
apply逐行判断,改用列表推导式或向量化转换(pd.Series(dt_list).isin(holiday_set)更快)
示例片段:
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强,支持文件上传与图片 URL 输入。
import pandas as pd
import holidays
from holidays import country_holidays
cn_holidays = country_holidays('CN', years=[2024, 2025])
dr = pd.date_range('2024-01-01', '2024-01-31', freq='D')
workdays = dr[(dr.weekday
<h3>用 <code>pd.bdate_range</code> 后接 <code>drop</code> 手动剔除节假日</h3>
<p>如果已有现成的 <code>bdate_range</code> 结果,又知道具体节假日列表,可以直接删:</p>
- 确保节假日列表是
datetime.date或能被pd.to_datetime解析的字符串(如'2024-02-10') - 用
.drop()时传入的是索引标签,不是布尔条件;错误写法:bd.drop('2024-02-10')可能报KeyError,正确做法是先转成pd.DatetimeIndex再删 - 更稳妥的是用布尔索引:
bd[~bd.isin(pd.to_datetime(['2024-02-10', '2024-02-11']))]
注意:调休上班日(如春节后周日上班)不会被自动识别为工作日,bdate_range 默认仍视其为周末,必须额外加回——这点容易被忽略。
处理调休日:必须单独标记并合并进工作日序列
中国法定节假日的核心难点不在放假,而在调休。比如 2024 年 2 月 4 日(周日)因春节调休要上班,但它既不是周一至周五,也不在 holidays.CN() 中(因为它是“工作日”,不是“假日”)。
解决方式只有两个:
- 维护一份调休日清单(每年国务院通知发布后手动更新),然后用
pd.concat([workdays, pd.to_datetime(adjustment_days)])合并 - 使用支持调休识别的第三方包(如
chinese-calendar),它提供is_workday(date)方法,内部已封装调休逻辑 - 别指望 pandas 原生函数自动处理调休——它没这个能力,也没这个设计目标
真正落地时,调休日的维护成本往往高于节假日本身,建议把调休表存成 CSV,每次加载时 pd.read_csv 后转 DatetimeIndex 再参与计算。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










