Python 日期库 -- pendulum

2022-10-10 今日头条喜欢编码的社畜

关于日期处理，Python/ target=_blank class=infotextkey>Python 提供了许多库，例如标准库 datetime、第三方库 dateutil、 Arrow 等。在这篇文章中，我想介绍我个人最喜欢的库pendulum，它使用非常方便，它可以满足任何日期的操作。

为什么使用Pendulum

原生datetime实例对于基本情况来说已经足够了，但是当您面对更复杂的用例时，它们通常会显示出局限性并且使用起来并不那么直观。Pendulum在仍然依赖标准库的同时提供了一个更干净、更易于使用的 API。

与 Python 的其他datetime库不同，Pendulum 是标准datetime类的直接替代品（它继承自它），因此，基本上，您可以用代码中datetime的实例替换所有实例DateTime（检查类型的库存在例外）通过使用type类似sqlite3或PyMySQL例如函数的对象）

它还消除了 naive 的概念datetimes：每个Pendulum实例都是时区感知的，并且默认情况下是UTC为了便于使用，Pendulum timedelta还通过提供更直观的方法和属性来改进标准类

安装Pendulum

直接使用pip install pendulum

pip install pendulum

基本用法

先来看看用法，首先是datetime、date、time的创建

import pendulum


dt = pendulum.datetime(2022,9,19,15,10,30)
print(dt)

# 改变时区
dt = pendulum.datetime(
    2022,9,19,15,10,30,tz="America/Los_Angeles")
print(dt)

# # 创建日期
d = pendulum.date(2022, 9, 19)
print(d)

# 创建时间
t = pendulum.time(15, 10, 30)
print(t)

pendulum对象时区默认为 UTC。如果不想要时区，或者想要时区为本地时区，那么pendulum也专门提供了两种方法

import pendulum


dt = pendulum.local(2022,9,19,15,10,30)
print(dt)
print(pendulum.local_timezone())


dt = pendulum.naive(2022,9,19,15,10,30)
print(dt)

pendulum还提供了几种方法，如创建当前日期时间、日期等。

import pendulum


dt = pendulum.today()
print(dt)

# 获取明天的日期
dt = pendulum.tomorrow()
print(dt)

# 获取昨天的日期
dt = pendulum.yesterday()
print(dt)

还可以从时间戳或字符串创建日期

import pendulum

# 基于给定的时间戳
dt1 = pendulum.from_timestamp(1663578465)
dt2 = pendulum.from_timestamp(1663578465,tz=pendulum.local_timezone())
print(dt1)
print(dt2)


# 基于时间字符串
dt1 = pendulum.parse("2022-09-19 12:11:33")
dt2 = pendulum.parse ("2022-09-19 12:11:33", tz=pendulum.local_timezone())
print(dt1)
print(dt2)

日期时间相关操作

import pendulum

dt = pendulum.local(
    2022, 9, 19, 20, 10, 30)

# 获取日期和时间
print(dt.date())
print(dt.time())


# 替换并返回新的日期
print(dt.replace(year=2088))


# 转换为时间戳
print(dt .timestamp())


# 返回年月日...
print(dt.year, dt.month, dt.day)
print(dt.hour, dt.minute, dt.second)
print(dt.tz)

pendulum.DateTime对象可以转换成各种格式的日期字符串

import pendulum

dt = pendulum.local(
    2022, 9, 19, 20, 10, 30)

# 最常使用
print("datetime:", dt.to_datetime_string())
print("date:", dt.to_date_string())
print("time:", dt.to_time_string())
print("iso8601:", dt.to_iso8601_string())
print("atom:", dt.to_atom_string())
print("rss:", dt.to_rss_string())
print("w3c:", dt.to_w3c_string())
print("cookie:", dt.to_cookie_string())
print("rfc822:", dt.to_rfc822_string())

有时我们还需要判断当前日期是星期几，当前日期是一年的多少周等等，pendulum也已经为我们封装好了。

import pendulum

dt = pendulum.local(
    2022, 9, 19, 20, 10, 30)

# 返回星期几
print(dt.isoweekday())

# 返回今年多少天
print(dt.day_of_year)

# 返回每月的天数
print(dt.days_in_month)

# 返回每个月中第几周
print(dt.week_of_month)

# 返回每年的第几周
print(dt.week_of_year)

# 检查闰年
print(dt.is_leap_year())

最后是日期的操作，这是pendulum最强大的部分。

import pendulum

dt = pendulum.local(
    2022, 9, 19, 20, 10, 30)

# 下个月今天
print(dt.add(months=1))

# 上个月今天
print(dt.add(months=-1))

和 Python 的内置模块一样datetime，添加日期时，最多支持天数，我们无法计算下周、下月、明年的日期。pendulum可以轻松处理，这是我最喜欢的一点。当然add里面的值是正数，相当于日期倒退；该值为负数，相当于将日期往前推。然后也可以减去两个日期

import pendulum

dt1 = pendulum.local(
    2021, 9, 19, 11, 22, 33)

dt2 = pendulum.local(
    2022, 9, 19, 20, 10, 30)

period = dt2 - dt1
# 返回 Period 对象
# 类似timedelta in datetime
print(period.__class__)



print(period.in_years())

print(period.in_months())

print(period.in_weeks ())

print(period.in_days())

print(period.in_hours())

print(period.in_minutes())

print(period.in_seconds())

pendulum功能非常强大。Python 的模块中的datetime只能计算两个日期之间最多相差多少天，这里可以使用年月日时分秒。

当然 pendulum不仅仅是我们上面提到的那些。有兴趣的可以参考官网：
https://github.com/sdispater/pendulum，不过上面提到这些都是常用的东西。