深入Pendulum:Python中处理日期和时间的更好方式¶

日期和时间是编程中的一个普遍话题，无论是日志记录、用户事件跟踪还是定期任务安排，我们几乎总是需要与时间打交道。在 Python 世界中，内置的 datetime 模块是处理日期和时间的传统工具，但它的接口有时并不直观，时区处理也比较繁琐。这就是 Pendulum 出现的舞台——一个更加简单、更强大且人性化的日期时间库。

Pendulum 简介¶

Pendulum 是一个第三方库，旨在弥补 Python datetime 模块的不足。它为日期时间的解析、操作和格式化提供了更加人性化且强大的工具。Pendulum 不仅提供了更好的 API，还内置了时区处理，并且完全兼容标准的 datetime 对象。

Pendulum 的一些突出特点包括：¶

时区处理： Pendulum 有内置的时区支持，并默认处理时间为 UTC。它让转换和处理时区变得非常简单。
易于使用的接口： Pendulum 提供了一个更直观、一致且链式的 API，使得日期和时间的操作更加直观和便捷。
自然语言支持：它可以很容易地解析和格式化日期时间，支持多种自然语言，让用户可以用自己熟悉的语言表达日期时间。
改进的 datetime 对象： Pendulum 提供了自己的 DateTime类，它是原生 datetime 类的一个完全兼容的替代品，拥有更多的功能和改进。
持续时间和周期处理：它提供了对持续时间（Period）和时间间隔（Duration）的支持，使得两个日期之间的差异计算和表示更加方便。
可序列化： Pendulum 的日期时间对象可以轻松地序列化为字符串，也可以从字符串反序列化，这对于存储和网络传输非常有用。

安装 Pendulum¶

在开始使用 Pendulum 之前，你需要先安装它。最简单的安装方式是使用 pip：

pip install pendulum
# 我在写这篇文章时使用的是 Python 3.8.12 Pendulum 2.1.2
# pip install pendulum==2.1.2

Pendulum 的使用¶

现在，让我们来看看如何使用 Pendulum 进行一些常见的日期和时间操作。

基本操作¶

import pendulum

# 获取当前时间
now = pendulum.now()
print(now.to_datetime_string())

# 解析字符串为日期时间
dt = pendulum.parse('2023-03-01T00:00:00Z')
print(dt.to_datetime_string())

# 指定时区的日期和时间
paris_time = pendulum.now('Europe/Paris')
print(paris_time)

输出

2024-02-27 17:34:49
2023-03-01 00:00:00
2024-02-27 10:34:49.670502+01:00

日期时间加减¶

import pendulum

# 添加时间
tomorrow = now.add(days=1)
print(tomorrow.to_date_string())

# 减去时间
last_week = now.subtract(weeks=1)
print(last_week.to_date_string())

# 获取两个日期之间的差异
difference = now.diff(last_week)
print(difference.in_words())

输出

2024-02-28
2024-02-20
1 week

时区处理¶

import pendulum

# 从一个区转换到另一个时区
local_time = pendulum.now('America/New_York')
print(local_time)

utc_time = local_time.in_timezone('UTC')
print(utc_time)

输出

2024-02-27 04:39:12.598295-05:00
2024-02-27 09:39:12.598295+00:00

格式化和解析¶

import pendulum

# 格式化日期时间
formatted = now.format('YYYY-MM-DD HH:mm:ss')
print(formatted)

# 解析自定义格式的日期时间字符串
custom_dt = pendulum.from_format('2023-03-01 12:00:00', 'YYYY-MM-DD HH:mm:ss')
print(custom_dt)

输出

2024-02-27 17:34:49
2023-03-01 12:00:00+00:00

与原生 datetime 兼容¶

import pendulum
from datetime import datetime

# 转换原生 datetime 对象为 Pendulum 对象
native_dt = datetime.now()
pendulum_dt = pendulum.instance(native_dt)
print(pendulum_dt.to_iso8601_string())

输出

2024-02-27T17:45:07.122113Z

Pendulum 的高级特性¶

除了基础的日期和时间操作，Pendulum 还提供了一些高级功能，让开发者能够轻松处理更复杂的日期时间场景。

人性化的时间差表示¶

Pendulum 使得时间差的表示更加人性化。你可以用自然语言来描述两个日期之间的差异：

import pendulum

# 两个时间点
dt1 = pendulum.now()
dt2 = dt1.add(hours=23, minutes=3)

# 人性化时间差表示
print(dt2.diff_for_humans(dt1))

输出

23 hours after

这种表示方式非常适合在用户界面中展示时间差，让用户能够以直观的方式理解时间间隔。

精确的时间跨度计算¶

处理时间跨度时，Pendulum 可以非常精确地考虑闰年、闰秒等因素：

import pendulum

# 计算两个日期之间确切的时间跨度
date1 = pendulum.datetime(2020, 2, 27)
date2 = pendulum.datetime(2021, 2, 27)

# 此处会考虑2020年是闰年的情况
print(date2.diff(date1).in_days())
# 输出："366"，而不是365，因为2020年有366天

输出

周和季度的操作¶

Pendulum 也可以轻松处理周和季度的计算：

import pendulum

# 获取当前时间的所在周的开始和结束日期
now = pendulum.now()
start_of_week = now.start_of('week')
end_of_week = now.end_of('week')
print(start_of_week.to_date_string(), end_of_week.to_date_string())

# 获取当前时间的所在季度的开始和结束日期
start_of_quarter = now.start_of('quarter')
end_of_quarter = now.end_of('quarter')
print(start_of_quarter.to_date_string(), end_of_quarter.to_date_string())

输出

2024-02-26 2024-03-03
2024-01-01 2024-03-31

本地化支持¶

Pendulum 提供了本地化支持，你可以根据需要将日期和时间格式化为不同的语言：

import pendulum

# 本地化格式化日期
localized = now.format('dddd, MMMM Do YYYY', locale='en')
print(localized)
localized = now.format('dddd, MMMM Do YYYY', locale='fr')
print(localized)
localized = now.format('dddd, MMMM Do YYYY', locale='zh')
print(localized)

输出

Tuesday, February 27th 2024
mardi, février 27e 2024
星期二, 二月 27 2024

特定用例：处理财务季度¶

Pendulum 对于处理涉及到特定日期计算的财务和业务逻辑也非常有用。例如，让我们计算财务季度的开始和结束日期：

import pendulum

# 假设财务年度从每年的1月1日开始
financial_year_start = pendulum.datetime(now.year, 1, 1)
if now < financial_year_start:
    financial_year_start = financial_year_start.subtract(years=1)

# 计算财务季度
current_quarter = (now.month - financial_year_start.month) // 3 + 1
quarter_start = financial_year_start.add(months=3 * (current_quarter - 1))
quarter_end = quarter_start.add(months=3).subtract(days=1)

print(f"Q{current_quarter} Start:", quarter_start.to_date_string())
print(f"Q{current_quarter} End:", quarter_end.to_date_string())

输出

Q1 Start: 2024-01-01
Q1 End: 2024-03-31

结语¶

Pendulum 给 Python 开发者带来了前所未有的便利性和效率，不论是在简单的日期时间操作还是复杂的时间计算方面。它的强大功能、人性化设计和易于理解的 API 使得它成为了处理日期和时间的首选库。

随着时间的发展，Pendulum 也在不断更新和增加新的特性。无论你是在构建一个需要精确时间管理的金融应用，还是只是想要更方便地处理日常的日期和时间任务，Pendulum 都能提供帮助。