高效处理日期与时间：pendulum 库完全入门指南（Python日期时间操作的现代解决方案）

为什么选择 pendulum？

相比 Python 内置的 datetime，pendulum 提供了以下优势：

• 更直观的 API 设计
• 内置时区支持，无需额外依赖
• 链式调用，代码更简洁
• 自动处理夏令时等复杂情况
• 与标准库兼容，可无缝替换

安装 pendulum

使用 pip 即可轻松安装：

pip install pendulum

基础用法：创建和格式化时间

使用 pendulum.now() 可以获取当前时间：

import pendulum# 获取当前本地时间dt = pendulum.now()print(dt)  # 输出类似：2024-06-15T14:30:45.123456+08:00# 获取 UTC 时间dt_utc = pendulum.now('UTC')print(dt_utc)

你也可以从字符串解析时间（这是 Python时间库 的核心功能之一）：

# 自动识别多种格式dt1 = pendulum.parse('2024-06-15')dt2 = pendulum.parse('June 15, 2024 2:30 PM')dt3 = pendulum.parse('2024/06/15 14:30:00')print(dt1.format('YYYY-MM-DD'))  # 输出：2024-06-15print(dt2.to_datetime_string())  # 输出：2024-06-15 14:30:00

时区处理：pendulum 的强项

pendulum 内置对时区的完美支持，无需像标准库那样依赖 pytz：

# 创建带时区的时间tokyo = pendulum.datetime(2024, 6, 15, 14, 30, tz='Asia/Tokyo')print(tokyo)  # 2024-06-15T14:30:00+09:00# 转换时区ny = tokyo.in_timezone('America/New_York')print(ny)  # 自动转换为纽约时间，并考虑夏令时

时间计算与比较

pendulum 让时间加减变得极其简单：

now = pendulum.now()# 加7天next_week = now.add(days=7)# 减2小时two_hours_ago = now.subtract(hours=2)# 判断是否在某个范围内if now.is_between(pendulum.yesterday(), pendulum.tomorrow()):    print("今天！")

人性化的时间显示

pendulum 支持“相对时间”显示，非常适合用于社交应用或日志系统：

past = pendulum.now().subtract(minutes=10)print(past.diff_for_humans())  # 输出：10 minutes agofuture = pendulum.now().add(hours=3)print(future.diff_for_humans())  # 输出：3 hours from now

总结

通过这篇 pendulum教程，你应该已经掌握了 pendulum 的基本用法。无论是创建、解析、格式化、计算还是时区转换，pendulum 都提供了比标准库更优雅、更安全的解决方案。对于需要频繁进行 Python日期时间操作 的项目，强烈推荐使用 pendulum 来提升开发效率和代码可读性。

赶快在你的下一个 Python 项目中试试这个强大的 Python时间库 吧！