dateutil：Python 日期时间处理的扩展利器

Python 标准库的 datetime 能处理基础日期时间，但遇上"下个月最后一个周五是几号""离明年复活节还有多久"这类需求，代码就写得磕磕绊绊了。dateutil 在 Python 社区有 19 年历史，Star 数 2619，专门解决标准库搞不定的复杂日期运算。

四个核心模块，覆盖高频日期场景

dateutil 的设计思路很直接：把常见的日期计算需求拆成四个独立模块，各管一摊。

relativedelta 负责计算相对时间差。标准库的 timedelta 只能处理天、秒、微秒这类固定单位，relativedelta 能直接算"下个月"“明年”“上周一”"本月最后一周"这种相对偏移。两个日期对象之间的差值也可以精确到年月日时分秒，而不是简单返回总天数。

rrule 实现了 iCalendar 规范的超集，支持灵活的重复规则。比如"找出所有 8 月 13 号且恰好是周五的年份"，一行 rrule 调用就能列出结果。RFC 格式的规则字符串也能直接解析。

parser 可能是最省事的一个模块。它能解析几乎所有常见格式的日期字符串，"Sat Oct 11 17:13:46 UTC 2003""2025/3/15""明天下午三点"这类五花八门的输入都能自动识别，不用手写格式模板。

tz 模块内置了基于 Olson 数据库的全球时区信息，支持系统 tzfile 文件、TZ 环境变量、固定偏移时区、UTC 时区和 Windows 注册表时区。做跨时区应用时不用再自己维护时区数据。

久经考验的社区项目

dateutil 从 2003 年启动，历经 Gustavo Niemeyer、Tomi Pieviläinen、Yaron de Leeuw 和 Paul Ganssle 四任主要维护者。项目的测试覆盖率很高，贡献指南也清晰。安装方式跟普通 Python 包一样，pip install python-dateutil 就行（包的 PyPI 名是 python-dateutil，导入时用 dateutil）。

适合什么人用

做定时任务调度的，日历应用的，报表导出的，日志时间解析的，dateutil 能省掉大量手写日期计算逻辑的时间。parser 模块对处理多来源、多格式时间数据的场景尤其好用。如果项目里已经在用 datetime，引入 dateutil 不需要大改代码结构，直接 import 对应子模块就能用。

上手建议

刚接触的话重点看 relativedelta 和 parser 两个模块，覆盖了大部分日常需求。rrule 的重复规则表达式上手稍慢，但官方文档上有很详细的示例可以参考。这个库稳定、成熟、文档清楚，加进项目依赖清单基本没什么风险。

。这个库稳定、成熟、文档清楚，加进项目依赖清单基本没什么风险。