1、引言

小屌絲：有沒有什么好的方式，讓我的時間轉換不那么費勁！
小魚：開門見山的說，Python自帶的datetime 模塊和 time模塊，不夠你用？
小屌絲：轉換的太費勁了，
小魚：知道費勁，說明你的擼碼有進步，不過，你這么一說，我確實想起來一個時間神器，一行代碼就搞定，
小屌絲：這是真的嗎？

小魚：你可以不信，但是不能阻擋我的表演！ ！

話不多說，小魚要開始表演了！！
今天來說的這個神器，就是pendulum，
對的，沒看錯，就是一個萬能時間輸出轉換神器！

2、pendulum模塊介紹

2.2 介紹

Pendulum 是一個 Python 包，用于簡化日期時間操作；
它提供的類是原生類的替代品（它們繼承自它們），
我們先簡單看個例子，如：我們要獲取 多倫多和溫哥華的時間差，
代碼實體

#-*- coding: utf-8 -*-
# @Time   : 2021-10-08
# @Author : Carl_DJ


import pendulum

#Toronto的時間
dt_Toronto = pendulum.datetime(2021,10,8,tz = 'America/Toronto')

#Vancouver的時間
dt_Vancouver = pendulum.datetime(2021,10,8,tz = 'America/Vancouver')

#輸出Toronto 和Vancouver相差的時長
print(dt_Toronto.diff(dt_Vancouver).in_hours())

輸出結果 ：

3

也就是說， 多倫多和溫哥華 有3個小時的時差！

小屌絲：我去~~ pendulum 這么牛嘛？？？
小魚：這是開胃菜，接著往下看！！

2.2 安裝

按照規矩，我們先安裝！

當然，最直接的方式，就是pip install

pip install pendulum

安裝完成就是這樣的，截圖如下：

當然，
如果不想每次都pip安裝，直接看這兩篇:

《Python3，選擇Python自動安裝第三方庫，從此跟pip說拜拜！！》
《Python3，我低調的只用一行代碼，就匯入Python所有庫！》

2.3 實體化時區

2.3.1 默認時區展示

代碼實體：

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum

#不指定任何時區
dt_dt = pendulum.datetime(2021,10,9)
#輸出默認時區
print(dt_dt.timezone.name)

運行結果：

UTC

如果不指定任何時區，那么輸出的就是默認時區 即：UTC

2.3.2 時區本地化

使用local()自動將時區設定為本地時區，

類似于datetime()

但是，不同點：

local()會自動將時區轉換本地時區；
類似于datetime() 并不會自動將時區轉換為本地時區；

代碼實體：

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum
#使用local()講時區設定為本地時區
dt_loc = pendulum.local(2021,10,8)
print(dt.timezone.name)

運行結果：

Asia/Shanghai

指定時區，輸出的時區結果是：Asia/Shanghai

敲黑板，知識點：

• 通過 timezone.name 屬性，可查看時間物件的具體時區；
• 也可以直接用 timezone_name 直接獲取；
• 屬性 timezone 可以簡寫成 tz；
• Pendulum 時區只支持用 時區名稱 設定時區，

2.3.3 時區切換

切換時區很方便，只要呼叫時間物件的 in_timezone 傳入引數 時區名稱 就可以了：

縮寫形式 in_tz 也可以被識別

代碼實體：

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum

#默認是上海時區
dt_p = pendulum.now()

#輸出默認時區時間
print(dt_p)

#把時區設定為溫哥華，并輸出
print(dt_p.in_timezone('America/Vancouver'))

輸出結果：

#默認時區上海的時間
2021-10-09T10:08:17.167020+08:00

#溫哥華的時間
2021-10-08T19:08:17.167020-07:00

2.3.4 時區運算

不同的時區，可以進行比較，運算等，我們來看下：

代碼實體

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum

dt_Toronto = pendulum.datetime(2021, 10, 8, 22, 33, 22, 0, tz='America/Toronto')
dt_Vancouver = pendulum.datetime(2021, 10, 8, 19, 33, 22, 0, tz='America/Vancouver')

print(f'列印多倫多時間：{dt_Toronto.to_datetime_string()}')
print(f'列印多倫多時區：{dt_Toronto.timezone_name}')
print(f'列印溫哥華時間：{dt_Vancouver.to_datetime_string()}')
print(f'列印溫哥華時區：{dt_Vancouver.to_datetime_string()}')

#比較兩個時區的差值是否相等
if  dt_Toronto == dt_Vancouver:
    print(True)
else:
    print(False)

#給兩個時區賦值
dt_Vancouver = dt_Vancouver.on(2021,10,1).at(0,0,0)
dt_Toronto = dt_Toronto.on(2021,10,1).at(0,0,0)

#使用diff()比較兩個時差的差值
dif_time = dt_Vancouver.diff(dt_Toronto).in_hours()
print(f'兩個時區的時間差：{dif_time}')

輸出結果：

列印多倫多時間：2021-10-08 22:33:22
列印多倫多時區：America/Toronto
列印溫哥華時間：2021-10-08 19:33:22
列印溫哥華時區：America/Vancouver
True
兩個時區的時間差：3

• 回傳True，是因為設定就是相差3小時，所以，回傳結果為True；
• 使用diff()，比較兩個時區的差值，回傳一個時間區間(Period)物件，

敲黑板，知識點：

diff 方法用于與另一個時間物件比較，
in_hours 方法是時間區間的方法，可以將區間轉化為小時，同理還有 in_days、in_years 等

2.4 時間運算

時間運算包括比較、計算差異 和 增減，

2.4.1 比較

比較很簡單，對兩個時間物件做比較就可以了，支持 ==、!=、>、>=、<、<=，比較的結果是 True 或 False，
代碼實體：
為了顯示直觀，我直接用IDLE 來運行

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum

dt_Toronto = pendulum.datetime(2021, 10, 8, 22, 33, 22, 0, tz='America/Toronto')
dt_Vancouver = pendulum.datetime(2021, 10, 8, 19, 33, 22, 0, tz='America/Vancouver')

>>> dt_Toronto = dt_Toronto.on(2021, 10, 1).at(0, 0, 0)
>>> dt_Vancouver = dt_Vancouver.on(2021, 10, 1).at(0, 0, 0)

>>> first == second
False
>>> first != second
True
>>> first > second
False
>>> first >= second
False
>>> first < second
True
>>> first <= second
True

這沒有什么難度， 在前面的代碼中，也有展示，

2.4.2計算差異

import pendulum

dt_Vancouver = pendulum.datetime(2021, 9, 30, 0)
dt_Toronto = pendulum.datetime(2021, 10, 1, 0)
print(f'溫哥華和多倫多時間比較：{dt_Vancouver.diff(dt_Toronto)}')
print(f'溫哥華與默認時區時間比較：{dt_Vancouver.diff()}')

輸出結果：

溫哥華和多倫多時間比較：<Period [2021-09-30T00:00:00+00:00 -> 2021-10-01T00:00:00+00:00]>
溫哥華與默認時區時間比較：<Period [2021-09-30T00:00:00+00:00 -> 2021-10-09T03:48:39.418295+00:00]>

在2.3.4章節提到了，diff()比較差異的方法，
這里就不再贅述，
這里說一下，如果diff()不傳引數，默認是與當前時區時間進行比較，

2.4.3 加減

加減時間，這里使用的是add()和subtract()方法，
并且每個方法都回傳一個新Datetime實體，

代碼實體：

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ


import pendulum

#設定當前時間戳
dt_now = pendulum.datetime(2021, 10, 1)
#列印dt_now的時間戳
print(f'列印出當前的時間戳：{dt_now.to_datetime_string()}')

#增加5年
dt_now = dt_now.add(years=5)
print(f'增加5年，顯示時間戳：{dt_now.to_datetime_string()}')
#減少3年，
dt_now = dt_now.subtract(years=3)
print(f'減少3年，顯示時間戳：{dt_now.to_datetime_string()}')

#增加4個月
dt_now = dt_now.add(months=4)
print(f'增加4個月，顯示時間戳：{dt_now.to_datetime_string()}')

#減少2個月
dt_now = dt_now.subtract(months=2)
print(f'減少2個月，顯示時間戳：{dt_now.to_datetime_string()}')


#增加1周
dt_now = dt_now.add(weeks=1)
print(f'增加1周，顯示時間戳：{dt_now.to_datetime_string()}')

#減少3周
dt_now = dt_now.subtract(weeks=3)
print(f'減少3周，顯示時間戳：{dt_now.to_datetime_string()}')

#增加9小時
dt_now = dt_now.add(hours=9)
print(f'增加9小時，顯示時間戳：{dt_now.to_datetime_string()}')

#減少6小時
dt_now = dt_now.subtract(hours=3)
print(f'減少6小時，顯示時間戳：{dt_now.to_datetime_string()}')

輸出結果：

列印出當前的時間戳：2021-10-01 00:00:00
增加5年，顯示時間戳：2026-10-01 00:00:00
減少3年，顯示時間戳：2023-10-01 00:00:00
增加4個月，顯示時間戳：2024-02-01 00:00:00
減少2個月，顯示時間戳：2023-12-01 00:00:00
增加1周，顯示時間戳：2023-12-08 00:00:00
減少3周，顯示時間戳：2023-11-17 00:00:00
增加9小時，顯示時間戳：2023-11-17 09:00:00
減少6小時，顯示時間戳：2023-11-17 06:00:00

敲黑板，知識點：

• add 和 subtract 方法引數一致，支持 years、months、weeks 等多種時間單位，而且可以一起設定
• 時間單位引數可以支持負數，相當于 add 和 subtract 可以相互替換
• 時間單位引數還支持小數，比如加上一天半可以寫成 dt.add(days=1.5)

2.5 時間調整

可以對時間進行調整，這個貌似很厲害的樣子，
我們一起來看看，

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum

dt_now = pendulum.datetime(2021, 10, 11,12,0,0)
#輸出當天開始時間
print(f'當天的開始時間：{dt_now.start_of("day")}')
#輸出當天結束時間
print(f'當天的結束時間：{dt_now.end_of("day")}')

#輸出當月開始時間
print(f'當月的開始時間：{dt_now.start_of("month")}')
#輸出當天結束時間
print(f'當月的結束時間：{dt_now.end_of("month")}')

#輸出21世紀開始時間
print(f'21世紀的開始時間：{dt_now.start_of("century")}')
#輸出21世紀結束時間
print(f'21世紀的結束時間：{dt_now.end_of("century")}')

# dt_now.day_of_week == pendulum.SUNDAY
#輸出距離當前最近的下一個周三的日期
print(f'下一個周三：{dt_now.next(pendulum.WEDNESDAY)}')
#輸出當前時間的本周周三的日期
print(f'本周的周三：{dt_now.previous(pendulum.WEDNESDAY)}')


dt_start = pendulum.datetime(2021, 10, 1)
dt_end = pendulum.datetime(2021, 10, 31)
#輸出本月的中間日期
print(f'本月的中間日期：{dt_start.average(dt_end)}')

敲黑板，知識點：

• start_of 方法用于計算某個起始時間，可以是 天、年、月、周，甚至可以是世紀，
• end_of ，用于計算結束；
• next 方法用于計算以一個星期，不加引數就是計算下個星期的今天，也可以指定計算下一個哪天，比如下個星期:dt.next(pendulum.WEDNESDAY)，
• previous ，用于計算向前的天；
• average 方法用于計算兩個時間的中間時間；

2.6 時間與字符轉換

2.6.1 時間轉換字符

時間物件是一個復雜的物件，對于我們來說不方便看和讀，就需要將起轉化為字串，或者將字串表示的時間轉化為時間物件，

Pendulum 提供和很多方便的方式：

代碼實體：

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum

dt = pendulum.datetime(1985, 9, 20, 13, 14, 15)

print(f'輸出當前時間：{dt}')

#輸出年月日
print(f'輸出年月日：{dt.to_date_string()}')

#英文形式輸出時間日期
print(f'英文形式輸出：{dt.to_formatted_date_string()}')

#輸出時間
print(f'輸出當前時間戳：{dt.to_time_string()}')

#轉化日期和時間
print(f'輸出轉化后的日期和時間：{dt.to_datetime_string()}')

print(f'輸出當前格式時間:{dt.to_day_datetime_string()}')

#格式化時間
print(f'格式化時間后輸出：{dt.format("dddd Do [of] MMMM YYYY HH:mm:ss A")}')

輸出結果：

輸出當前時間：1985-09-20T13:14:15+00:00
輸出年月日：1985-09-20
英文形式輸出：Sep 20, 1985
輸出當前時間戳：13:14:15
輸出轉化后的日期和時間：1985-09-20 13:14:15
輸出當前格式時間:Fri, Sep 20, 1985 1:14 PM
格式化時間后輸出：Friday 20th of September 1985 13:14:15 PM

敲黑板，知識點：

• to_date_string 轉化日期；
• to_datetime_string 轉化日期和時間；
• to_time_string 轉化時間；
• to_formatted_date_string 轉化為英文書寫形式；
• format 安裝指定格式轉化，

2.6.2 字符轉換時間

字串轉換成時間， 使用 parse 方法就可以，
代碼實體：

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum

dt = pendulum.parse('1985-09-20T23:11:22')

print(f'輸出當前時間：{dt}')

dt = pendulum.parse('1985-09-20T23:11:22', tz='America/Toronto')
print(f'輸出追加tz后的時間：{dt}')
#添加strict=False，讓pendulum盡可能的匹配我的想要的結果
dt = pendulum.parse('31-01-01', strict=False)
print(f"輸出結果為：{dt}")

dt = pendulum.parse('31/01/01', strict=False)
print(f"輸出結果為：{dt}")

輸出結果：

輸出當前時間：1985-09-20T23:11:22+00:00
輸出追加tz后的時間：1985-09-20T23:11:22-04:00
看下效果2031-01-01T00:00:00+00:00
看下效果2031-01-01T00:00:00+00:00

敲黑板，知識點：

• 可以直接轉化，也可以在轉化時指定時區
• 支持多種時間格式，如果不是標準的時間格式，需要添加引數 strict=False，這樣 Pendulum 就會盡最大可能去猜

2.7 人文關懷

小屌絲：為啥這個章節叫“人文關懷”，難道要給我們發福利 ？？
小魚：想啥呢~ ~
這個章節，主要介紹pendulum最最最，最Nice的功能：人性化時間
小屌絲：咋人性化了，我沒看出來呢？
小魚：別著急，往下看！

先代碼展示：

#-*- coding: utf-8 -*-
# @Time   : 2021-10-09
# @Author : Carl_DJ

import pendulum

#1天前
dt_ago = pendulum.now().subtract(days=1).diff_for_humans()
print(f'輸出1天前：{dt_ago}')

#1年后
dt_after = pendulum.now().diff_for_humans(pendulum.now().subtract(years=1))
print(f'輸出1年后：{dt_after}')

#1個月前
dt = pendulum.datetime(2011, 8, 1)
print(f'輸出1個月前：{dt.diff_for_humans(dt.add(months=1))}')

#5秒后
dt_sec = pendulum.now().add(seconds=5).diff_for_humans()
print(f'輸出5 秒后：{dt_sec}')

#3周前
dt_wek = pendulum.now().subtract(days=24).diff_for_humans()
print(f'輸出3周前：{dt_wek}')

#設定輸出結果顯示中文
pendulum.set_locale('zh')
#輸出3周前，中文顯示
dt_wk = pendulum.now().subtract(days=24).diff_for_humans()
print(f'輸出3 周前：{dt_wk}')

#5秒后
dt_seco = pendulum.now().add(seconds=5).diff_for_humans()
print(f'輸出5秒后:{dt_seco}')

#1天
oneday = pendulum.now().diff(pendulum.now().add(days=1))
print(f'輸出1天：{oneday.in_words()}')

輸出結果：

輸出1天前：1 day ago
輸出1年后：1 year after
輸出1個月前：1 month before
輸出5 秒后：in a few seconds
輸出3周前：3 weeks ago
輸出3 周前：3周前
輸出5秒后:5秒鐘后
輸出1天：1天

敲黑板，知識點：

• diff_for_humans 可以將時間區間直接輸出成人性化時間；
• 引數 absolute 的作用是給出一個人性化的時間間隔，而不是相對于現在的說法；
• 默認輸出的是英文，如果要讓說中文，通過 pendulum.set_locale(‘zh’)就可以；
• 對于一個時間區域來說，可以用 in_words 來輸出人性化時間，

注意點：

對于 dt.diff_for_humans(dt.subtract(months=1)) 這樣的，相對一個日期的時間差異人性化輸出，不支持中文，會報錯；
所以，建議先計算兩個日期的差異，再用in_words 做人性化輸出，