datetime.date减法结果不含结束日,即date2-date1表示[date1, date2)区间天数;需包含首尾时应加1;跨年跨月不影响逻辑,但不可用字符串比较替代date运算。

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)算星期几时,如果配合日期偏移(如“上周一”),很容易因起始日定义不同导致偏差。
立即学习“Python免费学习笔记(深入)”;
-
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
事情说清了就结束。日期边界问题从来不在函数会不会用,而在你心里有没有明确“这个‘之间’到底包不包含端点”“这个‘月’是指日历月还是固定天数”“这个‘周一’是以谁为基准算的”。










