Pendulum：Python 日期时间处理的终极解决方案

最新推荐文章于 2026-06-28 17:29:25 发布

原创最新推荐文章于 2026-06-28 17:29:25 发布 · 219 阅读

本内容遵循CC 4.0 BY-SA版权协议

标签

#python #网络 #开发语言 #其他

处理日期时间是 Python 开发中绕不开的需求，但原生 datetime 模块总有各种让人头疼的问题：时区处理麻烦、夏令时转换不直观、时间差计算不够人性化等等。Pendulum 就是为解决这些痛点而生的工具，目前在 GitHub 上已经积累了 6.6k+ Star。

正文顶部截图

Pendulum 最核心的优势在于它是原生 datetime 模块的增强版，而非完全重写。这意味着你可以无缝替换代码中的 datetime 实例，无需大规模重构。

原生 datetime 的时区处理一直是痛点，Pendulum 让这一切变得简单：

>>> import pendulum
>>> now_in_paris = pendulum.now('Europe/Paris')
>>> now_in_paris.in_timezone('UTC')
'2016-07-03T22:49:58.502116+00:00'

加减时间、计算时间差都变得更加直观：

>>> tomorrow = pendulum.now().add(days=1)
>>> last_week = pendulum.now().subtract(weeks=1)
>>> past.diff_for_humans()
'2 minutes ago'

Pendulum 会自动处理夏令时转换等复杂情况，无需手动计算：

>>> pendulum.datetime(2013, 3, 31, 2, 30, tz='Europe/Paris')
'2013-03-31T03:30:00+02:00' # 自动跳过不存在的时间

Pendulum 继承自原生 datetime 类，大部分 API 保持一致。如果你已经熟悉 datetime，几乎不需要学习成本就能上手。

Pendulum 移除了原生 datetime 中 “naive” 时间的概念，所有实例都带有时区信息，避免了因时区缺失导致的潜在问题。

Pendulum 对 timedelta 也进行了增强，提供了更直观的方法和属性：

>>> delta = past - last_week
>>> delta.hours
23
>>> delta.in_words(locale='en')
'6 days 23 hours 58 minutes'

README区域截图

我在多个项目中使用过 Pendulum，最大的感受是它让日期时间代码变得更简洁、更易读。之前需要几行代码才能完成的时区转换，现在一行就能搞定。

当然，Pendulum 也不是完美的。在某些需要严格依赖原生 datetime 类型的场景（如数据库操作），可能需要进行类型转换。但官方文档已经提供了详细的解决方案。

如果你属于以下情况，强烈建议尝试 Pendulum：

Pendulum 不是那种花里胡哨的工具，它专注于把一件事做到极致——让 Python 的日期时间处理变得简单。如果你受够了原生 datetime 的各种痛点，不妨试试 Pendulum，相信它会给你带来惊喜。

项目已经稳定维护多年，文档完善，社区活跃。无论是个人项目还是企业级应用，Pendulum 都是值得信赖的选择。

，不妨试试 Pendulum，相信它会给你带来惊喜。

项目已经稳定维护多年，文档完善，社区活跃。无论是个人项目还是企业级应用，Pendulum 都是值得信赖的选择。