Python日期计算常见边界问题解析

Python日期计算中潜藏着大量易被忽视的边界陷阱：`date2 - date1` 得到的是左闭右开区间 `[date1, date2)` 的天数，不包含结束日，业务上常见的“包含首尾”的需求必须手动加1；跨年跨月虽不影响减法逻辑，但字符串比较会彻底失效；`datetime` 运算需警惕时区对齐、时间精度干扰及`.date()`预处理；标准库无真正“按月”计算能力，`timedelta(days=90)` 无法替代 `relativedelta(months=3)` 对月末日期的智能处理；而星期计算、ISO周与常规年份的错位更让`%w`/`%u`、`weekday()`/`isoweekday()`混用风险陡增——所有问题的根源，都不在代码写得对不对，而在于你是否在动笔前就清晰定义了“之间是否含端点”“月是日历月还是固定天数”“周一以谁为基准”这些看似简单却决定结果正确性的关键语义。

datetime.date 之间的减法不包含结束日

用 date2 - date1 得到的是「从 date1（含）到 date2（不含）」的天数，这是最常被误读的边界。比如 2023-01-01 到 2023-01-02 的差是 timedelta(days=1)，不是 2 天。

• 如果你要算「包含首尾两天」的总日历天数，得手动加 1：(date2 - date1).days + 1
• 业务上常说的“请假 3 天”，通常指 1 号、2 号、3 号——对应 date(2023,1,1) 到 date(2023,1,4) 的差值
• 跨年、跨月不影响逻辑，但别用字符串比大小替代 date 运算，否则会出错

datetime.datetime 减法要考虑时区和时间部分

datetime 对象相减返回 timedelta，但结果精度取决于你是否关心小时/分钟。比如 datetime(2023,1,1,23,59) 和 datetime(2023,1,2,0,1) 相差仅 2 分钟，.days 是 0，.total_seconds() 才是关键。

• 若只关心日期层面间隔，先用 .date() 转成 date 再算，避免时间部分干扰
• 带时区的 datetime（如 pytz 或 zoneinfo）必须对齐时区再减，否则可能抛 TypeError: can't subtract offset-naive and offset-aware datetimes
• 用 zoneinfo.ZoneInfo("Asia/Shanghai") 创建时区对象比 pytz.timezone() 更安全，尤其在夏令时切换点附近

monthdelta 类库不能直接替代 timedelta

Python 标准库没有「按月计算间隔」的类型，timedelta 只认天、秒、微秒。所谓“3 个月后”在不同起始日含义不同（1 月 31 日 + 1 月 ≠ 2 月 31 日），所以 dateutil.relativedelta 是更靠谱的选择。

• 别用 timedelta(days=30*3) 模拟 3 个月，它会在 1 月 31 日 + 90 天变成 5 月 1 日，而实际业务可能期望 4 月 30 日
• relativedelta(months=3) 会智能处理月末日期：从 date(2023,1,31) 加 1 个月得 date(2023,2,28)
• 注意 relativedelta 不支持直接与 timedelta 混用，也不能用于 datetime 的加减以外的运算（比如不能做乘除）

strftime 格式化时的 weekday 边界容易错位

用 %w（周日=0）和 %u（周一=1）算星期几时，如果配合日期偏移（如“上周一”），很容易因起始日定义不同导致偏差。

• date.weekday() 返回 0（周一）~6（周日），而 date.isoweekday() 是 1（周一）~7（周日）——别混用
• 求“本周周一”，常用 d - timedelta(days=d.weekday())；但若 d 是周日，d.weekday() 是 6，结果就是上周一，不是本周末往前推
• ISO 周计算（%G-%V）和普通年月日不一一对应：2023-01-01 属于 ISO 周 2022-W52，直接用 strftime('%Y-%U') 会返回 2023-00

事情说清了就结束。日期边界问题从来不在函数会不会用，而在你心里有没有明确“这个‘之间’到底包不包含端点”“这个‘月’是指日历月还是固定天数”“这个‘周一’是以谁为基准算的”。

到这里，我们也就讲完了《Python日期计算常见边界问题解析》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！