深入理解Pendulum：Python日期时间处理利器-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00804/article/details/148467896

深入理解Pendulum：Python日期时间处理利器

pendulum Python datetimes made easy 项目地址: https://gitcode.com/gh_mirrors/pe/pendulum

什么是Pendulum？

Pendulum是一个专门为Python设计的日期时间处理库，它旨在简化复杂的日期时间操作。与Python内置的datetime模块相比，Pendulum提供了更直观、更强大的API接口，同时完全兼容原生datetime类型。

为什么选择Pendulum？

在Python中进行日期时间处理时，开发者经常会遇到以下痛点：

时区处理复杂且容易出错
日期时间计算不够直观
格式化输出不够灵活
国际化支持有限

Pendulum正是为解决这些问题而生，它提供了：

更人性化的API设计
完善的时区支持
丰富的日期时间计算方法
直观的时间差表示
更好的国际化支持

核心特性解析

1. 无缝兼容原生datetime

Pendulum的所有日期时间类都是原生Python datetime类的子类，这意味着：

import pendulum
from datetime import datetime

# Pendulum创建的datetime对象可以无缝用于原生datetime函数
dt = pendulum.datetime(2023, 5, 15)
isinstance(dt, datetime)  # 返回True

2. 强大的时区处理能力

Pendulum对时区的处理是其最突出的特点之一：

# 创建带时区的日期时间对象
dt_tokyo = pendulum.datetime(2023, 5, 15, tz='Asia/Tokyo')
dt_ny = pendulum.datetime(2023, 5, 15, tz='America/New_York')

# 自动处理时区转换
print(dt_tokyo.diff(dt_ny).in_hours())  # 输出时区差

3. 默认时区策略

Pendulum采用以下时区策略：

默认创建UTC时间（除非明确指定时区）
now()方法使用本地时区
所有比较操作都在UTC或对象自身时区下进行

基础使用示例

创建日期时间对象

# 当前时间（本地时区）
now = pendulum.now()

# 指定日期时间
dt = pendulum.datetime(2023, 5, 15, 12, 30)

# 解析字符串
dt = pendulum.parse('2023-05-15T12:30:00')

时间计算

# 加减时间
tomorrow = pendulum.now().add(days=1)
last_week = pendulum.now().subtract(weeks=1)

# 计算时间差
dt1 = pendulum.datetime(2023, 5, 15)
dt2 = pendulum.datetime(2023, 6, 15)
diff = dt2.diff(dt1)
print(diff.in_days())  # 输出31

格式化输出

dt = pendulum.now()
print(dt.to_date_string())      # 2023-05-15
print(dt.to_time_string())      # 12:30:45
print(dt.to_datetime_string())  # 2023-05-15 12:30:45
print(dt.to_iso8601_string())   # 2023-05-15T12:30:45+08:00