Python最好的日期处理库pendulum的使用指南

介绍

Pendulum是一个用于日期时间处理的Python软件包。它提供了更加简单和更加美观的 API，因此代码更加易于编写和理解，同时还提供了比 Python 内置模块 datetime 更强大的功能。

Pendulum 库的主要特点包括：

• 更加流畅的 API
• 函数式编程支持
• 支持时区、夏令时、Unix 时间戳等
• 支持人类语言日期解析
• 提供本地化支持

安装pendulum库

安装Pendulum非常简单，使用pip即可完成安装。在终端（Linux、MacOS）或者命令行（Windows）中输入下面的命令。

pip install pendulum

基本用法

导入pendulum库

在使用 Pendulum 之前，首先需要导入它。

import pendulum

创建Pendulum实例

Pendulum 实例代表了一个日期和时间。可以使用 pendulum.create() 方法或 pendulum.datetime() 方法创建一个实例。

# 使用 pendulum.create() 方法创建
dt = pendulum.create(2019, 4, 29, 12, 30, 45)
# 使用 pendulum.datetime() 方法创建
dt = pendulum.datetime(2019, 4, 29, 12, 30, 45)

获取日期时间信息

可以通过 year、month、day、hour、minute、second 方法获取日期时间信息。

dt = pendulum.create(2019, 4, 29, 12, 30, 45)
print(dt.year)      # 2019
print(dt.month)     # 4
print(dt.day)       # 29
print(dt.hour)      # 12
print(dt.minute)    # 30
print(dt.second)    # 45

获取日期时间戳

可以通过 timestamp() 方法获取 Unix 时间戳。

dt = pendulum.create(2019, 4, 29, 12, 30, 45)
print(dt.timestamp())   # 1556533845

设置时区

可以使用 in_timezone() 方法设置时区。时区使用 Olson 数据库 的命名规则。

dt = pendulum.create(2019, 4, 29, 12, 30, 45)
dt = dt.in_timezone('Asia/Shanghai')
print(dt)   # 2019-04-29T12:30:45+08:00

格式化输出

可以使用 strftime() 方法将 Pendulum 实例格式化。Pendulum 使用 PHP strftime 函数，所以与 strftime 函数的格式字符串相同。

dt = pendulum.create(2019, 4, 29, 12, 30, 45)
dt = dt.in_timezone('Asia/Shanghai')
print(dt.strftime('%Y-%m-%d %H:%M:%S %Z'))   # 2019-04-29 12:30:45 CST

日期操作

Pendulum 实例可以进行加减操作。

dt = pendulum.datetime(2019, 4, 29, 12, 30, 45)
dt = dt.add(days=3, hours=-2)
print(dt.strftime('%Y-%m-%d %H:%M:%S'))   # 2019-05-02 10:30:45

解析人类语言日期

可以使用 parse() 方法解析人类语言日期。

dt = pendulum.parse('2019年5月2日上午10点30分15秒')
print(dt.strftime('%Y-%m-%d %H:%M:%S'))   # 2019-05-02 10:30:15

示例说明

示例一

在本地时间下，现在距离下一次万圣节还有多少天、多少小时、多少分钟，以及距离下一次圣诞节还有多少天、多少小时、多少分钟。需要考虑夏令时和时区的影响。

import pendulum

halloween = pendulum.create(2021, 10, 31, tz='local')
now = pendulum.now(tz='local')

# 计算距离下一次万圣节还有多少天、多少小时、多少分钟
delta_halloween = now.diff(halloween)
days = delta_halloween.in_days()
hours = delta_halloween.in_hours() % 24
minutes = delta_halloween.in_minutes() % 60
print(f'距离下一次万圣节还有 {days} 天，{hours} 小时，{minutes} 分钟')

christmas = pendulum.create(now.year, 12, 25, tz='local')

if christmas < now:
    # 跨年的情况
    christmas = christmas.add(years=1)

# 计算距离下一次圣诞节还有多少天、多少小时、多少分钟
delta_christmas = now.diff(christmas)
days = delta_christmas.in_days()
hours = delta_christmas.in_hours() % 24
minutes = delta_christmas.in_minutes() % 60
print(f'距离下一次圣诞节还有 {days} 天，{hours} 小时，{minutes} 分钟')

示例二

在不同时区之间进行时间转换。假设有一个北京时间为2022年1月1日14点30分的时间，需要将它转换为纽约时间。

import pendulum

beijing_time = pendulum.create(2022, 1, 1, 14, 30, tz='Asia/Shanghai')
new_york_time = beijing_time.in_timezone('America/New_York')

print('北京时间：', beijing_time.strftime('%Y-%m-%d %H:%M:%S %Z'))
print('纽约时间：', new_york_time.strftime('%Y-%m-%d %H:%M:%S %Z'))

结论

Pendulum 是一个功能强大、易于使用的日期时间处理库，提供了丰富的函数和易用的 API，使时间操作变得简单和明了。无论您是在编写业务应用还是完成数据分析任务，使用 Pendulum 都能节省您许多时间和精力，并且能够有效地提高开发效率。