Pendulum：可能是最好的 Python DateTime 库

datetime 模块是 Python 中最重要的内置模块之一，它为实际编程问题提供许多开箱即用的解决方案，非常灵活和强大。例如，timedelta 是我最喜欢的工具之一。

不过不得不说，datetime模块也有一些限制。 例如，当我们处理时区时，通常会显得短缺。有时，我们不得不引入一些第三方库作为补充。 此外，datetime 模块中的某些方面在其他编程语言中不很直观或不常用。

在本文中，我将介绍一个名为 Pendulum 的第三方库，它将解决内置 datetime 模块的所有问题，欢迎收藏学习，喜欢点赞支持，文末提供技术交流群。

1.直接替换 datetime

使用 pytz 等第三方库来解决一些 Python datetime不擅长的问题并不少见。但是，我们仍然需要导入 datetime 模块并将其用作必不可少的，因为我们需要使用它来实例化 datetime 对象。

让我向你展示为什么 Pendulum 是一种替代品。 首先，我们需要使用pip安装它。

pip install pendulum

该库的名称有点长，因此我建议使用别名导入它

import pendulum as pdl

虽然 pd 是一个较短的缩写，但我会为 Pandas 保留它。不想制造任何混乱。

让我们使用 Pendulum 创建一个 datetime 对象，并看看它的对象类型。

from datetime import datetime
dt = pdl.datetime(2021, 11, 6)
isinstance(dt, datetime)

Pendulum 继承了 Python datetime 对象。 因此，我们无需担心使用 datetime 模块中的一些原始功能。 从字面上看，Pendulum datetime 对象是 Python datetime 对象。

2. 时区

Pendulum 库最令人印象深刻的功能是时区， 这也是内置 datetime 模块的关键问题之一。 在 Python 3.9 之前，如果我们想使用 IANA 时区，我们必须涉及 pytz。

使用 Pendulum 库，我们可以像这样轻松地创建一个带有时区的日期时间对象。

dt_melbourne = pdl.datetime(2021, 11, 6, tz='Australia/Melbourne')
dt_brisbane = pdl.datetime(2021, 11, 6, tz='Australia/Queensland')
print(dt_melbourne)
print(dt_brisbane)

在上面的例子中，我们同时创建了两个对象。 但是，时区是不同的。 Pendulum 还允许我们轻松比较时间。

dt_melbourne.diff(dt_brisbane).in_hours()

多么容易啊！ 比较具有不同时区的两个日期时间对象并获得确切结果！

如果我们需要定义多个 datetime 对象并希望重新使用 timezone 字符串，我们可以创建一个 timezone 对象并将其传递给 datetime 构造函数。

my_timezone = pdl.timezone('Australia/Melbourne')
dt_melbourne = pdl.datetime(2021, 11, 6, tz=my_timezone)
print(dt_melbourne)
print(dt_melbourne.timezone.name)

另一个很酷的功能是将时间返回到不同的时区。 例如，墨尔本是午夜，那么布里斯班是几点？

3. 日期时间解析

解析日期时间可能是编程中最常见的用例，Python datetime 模块做得很好。 但是与大多数其他编程语言相比，Python 使用了不同的格式 %Y%m%d。

Pendulum 允许我们使用如下常见的格式代码

pdl.from_format('2021-11-06 22:00:00', 'YYYY-MM-DD HH:mm:ss')

此外，它完全支持 RFC 3339 和 ISO 8601 格式，以及其他一些常见格式。 这意味着我们不必指定格式代码来将字符串解析为日期时间。

Pendulum 还集成了许多常见的日期时间扩展，例如 dateutil。 如果我们希望库依赖于 dateutil 解析器，我们可以传递标志 strict=False。

pdl.parse('21-11-06', strict=False)

除此之外，Pendulum 即时支持更多格式。 例如，只有数字的日期时间。

这个很有趣，指定年份、周数和那一周的日期，Pendulum 给你正确的日期时间。

如果我们特别想要一个日期对象或一个时间对象，只需指定exact=True，这比Python datetime 模块容易得多。

4. 字符串格式化

将字符串解析为日期时间对象后，下一件重要的事情就是将日期时间输出为具有格式的字符串。

首先，让我们有一个 datetime 对象。 由于 Pendulum 继承了 Python datetime，我们可以使用 now() 等所有方法。

然后，让我从 Pendulum 中挑选几个“to string”方法的例子，看看用开箱即用的格式输出日期时间是多么容易。

dt.to_date_string()  # with date only
dt.to_time_string()  # with time only
dt.to_formatted_date_string()  # month_abbr date, year
dt.to_day_datetime_string() # day, month_abbr date, year hh:mm am/pm
dt.to_iso8601_string()  # to ISO 9601 standard
dt.to_atom_string()  # to Atom format
dt.to_cookie_string()  # to cookie style format

当然，我们可以使用格式码来自定义输出字符串，格式更直观。

另一个很酷的东西是我们可以轻松地将一些不相关的字符串添加到格式字符串中，并让它们脱离格式。

5. 人类可读性

在内置的 Python datetime 模块中，timedelta 工具可以很好地完成比较工作。 然而，Pendulum 甚至可以通过在比较两个日期时间对象时提供一些更人性化的输出来改进它。

例如，diff_for_humans() 方法将日期时间对象与当前时间进行比较，并返回一个非常人性化的输出。

6. 查找相对日期时间

内置 Python 日期时间可以改进的方面之一是根据给定的日期时间查找相对日期时间。 例如，当我们要查找当月的最后一天时，我们必须使用 datetutil 模块中的 relativedelta。

from dateutil.relativedelta import relativedelta
datetime.datetime(2013, 2, 21) + relativedelta(day=31)

此外，代码不是很可读，因为我们使用 day=31 作为参数，尽管当月份少于 31 天时它会起作用。

在 Pendulum 中，再简单不过了。

内置 datetime 模块的另一个不便之处是查找一周中的某一天。 例如，如果我们要查找下周一的日期，这可能是最简单的方法。

from datetime import datetime, timedelta
datetime.now() + timedelta(days=(0-datetime.now().weekday()+7)%7)

它可以完成这项工作，但可读性差。 开发人员需要花一些时间来理解这行代码的逻辑是什么。

使用 Pendulum，就这么简单

我们甚至不用考虑用 0 还是 1 来表示星期一，因为 Pendulum 使用枚举来表示星期一。

同样，我们可以使用 previous() 方法来查找上一个星期二，如下所示。 此外，我们可以通过设置参数 keep_time=True 来保留时间部分。

7. 一些额外的便利

这个库中隐藏着更多的“秘密”。 再举几个例子，比如昨天或明天。

输出具有不同文化和语言区域设置的日期时间也很容易。

再举一个例子。 如果一个人出生于 1988 年 1 月 1 日，那么这个人的年龄是多少？

总结

在本文中，我介绍了Python 第三方库 Pendulum，它是 Python 内置 datetime 模块的直接替代品。 通过使用这个库，datetime 模块可以解决的许多问题，例如查找相对日期，现在都可以轻松解决。

更重要的是，Pendulum 提供了整洁干净的 API 来提高我们代码的可读性，并且这些解决方案更加直观。

---

技术交流

欢迎转载、收藏、有所收获点赞支持一下！

目前开通了技术交流群，群友已超过2000人，添加时最好的备注方式为：来源+兴趣方向，方便找到志同道合的朋友

• 方式①、发送如下图片至微信，长按识别，后台回复：加群；
• 方式②、添加微信号：dkl88191，备注：来自CSDN
• 方式③、微信搜索公众号：Python学习与数据挖掘，后台回复：加群