Python之深入解析优秀的时间格式转换工具Delorean

Posted 2021-10-27 Forever_wj

一、前言

• DeLorean 是一个 Python 的第三方模块，基于 pytz 和 dateutil 开发的，用于处理 Python 中日期时间的格式转换。
• 由于时间转换是一个足够微妙的问题，DeLorean 希望为移位、操作和生成日期时间提供一种更干净、更省事的解决方案。比如，实例化字符串形式的时间对象，Delorean 只需要 parse 指定字符串，不需要声明其格式就可以进行转换。
• 至于 Delorean 这个模块名称的由来，Delorean 是电影《回到未来》里的那辆极为炫酷的鸥翼汽车，采用这部电影里的非常具有代表性的汽车的名字作为库名，作者估计也是想表达使用这个库能让我们在时空里任意遨游，没有掣肘。

二、准备

① Python 安装

• 在 windows 上安装 Python：
• • 下载 Python 的最新版本：访问链接 Python 官网，在 Windows 操作系统上安装 Python 3.10.0，大家也可以自行选择最新版的下载。

• • 进入下一个页面后，拉到最下面，选择 Windows embeddable package (64-bit) 下载：

• • 双击下载完成的应用程序，记得一定要勾选 ADD Python 3.7 to PATH，否则 cmd 无法运行 Python，然后选择 Install Now 进行安装，默认会安装 pip，而且将安装到 C 盘（推荐）。如果希望换一个盘安装，可以点击 Customize installation 在里面选择其他的盘。
• 在 macOS 上安装 Python：
• • 其实 macOS 上是默认安装了 Python 的，只不过版本是 Python2.7，其相对于现在的 Python 3 缺少了很多特性，而且速度也比 Python 3 慢，因此还是建议大家装 Python 3。
• • 同样地，下载 Python 的最新版本，访问链接：Python 官网，在 macOS 操作系统上安装 Python 3.7.4，大家也可以自行选择最新版的下载。

• • 进入下一个页面后，拉到最下面，选择 macOS 64-bit universal2 installer 下载：

• • 下载完成后得到一个 pkg 文件，双击打开，按照指示步骤进行安装即可。

② 安装依赖

• 请选择以下任一种方式输入命令安装依赖：
• • Windows 环境打开 Cmd (开始 - 运行 - CMD)；
• • MacOS 环境打开 Terminal (command + 空格输入 Terminal)；
• • 如果使用的是 VSCode 编辑器或 Pycharm，可以直接使用界面下方的 Terminal。

pip install Delorean

三、Delorean 基础使用

• 轻松获取当前时间：

from delorean import Delorean

d = Delorean()
print(d)
# Delorean(datetime=datetime.datetime(2021, 10, 6, 9, 5, 57, 611589), timezone='UTC')

• 将 datetime 格式的时间转化为 Delorean：

import datetime
from delorean import Delorean

d = Delorean()
print(d)
d = Delorean(datetime=datetime.datetime(2018, 5, 10, 8, 52, 23, 560811), timezone='UTC')
# 这里默认的是UTC时间
print(d)
# Delorean(datetime=datetime.datetime(2021, 10, 6, 9, 5, 57, 611589), timezone='UTC')
# Delorean(datetime=datetime.datetime(2018, 5, 10, 8, 52, 23, 560811), timezone='UTC')

• 转换为国内时区：

import datetime
from delorean import Delorean

d = Delorean(datetime=datetime.datetime(2018, 5, 10, 8, 52, 23, 560811), timezone='UTC')
d = d.shift("Asia/Shanghai")
print(d)
# Delorean(datetime=datetime.datetime(2018, 5, 10, 16, 52, 23, 560811), timezone='Asia/Shanghai')

• 输出为 datetime、date 也不在话下：

import datetime
from delorean import Delorean

d = Delorean(datetime=datetime.datetime(2018, 5, 10, 8, 52, 23, 560811), timezone='UTC')
d = d.shift("Asia/Shanghai")
print(d.datetime)
print(d.date)
# 2018-05-10 16:52:23.560811+08:00
# 2018-05-10

• 查看无时区时间及时间戳：

import datetime
from delorean import Delorean

d = Delorean(datetime=datetime.datetime(2018, 5, 10, 8, 52, 23, 560811), timezone='UTC')
d = d.shift("Asia/Shanghai")
print(d.epoch)
print(d.naive)
# 1525942343.560811
# 2018-05-10 08:52:23.560811

• 用 unix 时间戳初始化 Delorean：

from delorean import epoch
d = epoch(1357971038.102223).shift("Asia/Shanghai")
print(d)
# Delorean(datetime=datetime.datetime(2013, 1, 12, 14, 10, 38, 102223), timezone='Asia/Shanghai')

• Delorean 支持 timedelta 的时间加减法。Delorean 可以使用 timedelta 进行加减，得到一个 Delorean 对象：

import datetime
from delorean import Delorean

d = Delorean(datetime=datetime.datetime(2018, 5, 10, 8, 52, 23, 560811), timezone='UTC')
d = d.shift("Asia/Shanghai")
print(d)
d2 = d + datetime.timedelta(hours=2)
print(d2)
d3 = d - datetime.timedelta(hours=3)
print(d3)
# Delorean(datetime=datetime.datetime(2018, 5, 10, 16, 52, 23, 560811), timezone='Asia/Shanghai')
# Delorean(datetime=datetime.datetime(2018, 5, 10, 18, 52, 23, 560811), timezone='Asia/Shanghai')
# Delorean(datetime=datetime.datetime(2018, 5, 10, 13, 52, 23, 560811), timezone='Asia/Shanghai')

四、Delorean 高级使用

• 通常情况下不关心有多少微妙或者多少秒，因此 Delorean 提供了非常方便的过滤方式：

from delorean import Delorean

d = Delorean()
print(d)
# Delorean(datetime=datetime.datetime(2019, 3, 14, 4, 0, 50, 597357), timezone='UTC')
d.truncate('second')
# Delorean(datetime=datetime.datetime(2019, 3, 14, 4, 0, 50), timezone='UTC')
d.truncate('hour')
# Delorean(datetime=datetime.datetime(2019, 3, 14, 4, 0), timezone='UTC')
d.truncate('month')
# Delorean(datetime=datetime.datetime(2019, 3, 1, 0, 0), timezone='UTC')
d.truncate('year')
# Delorean(datetime=datetime.datetime(2019, 1, 1, 0, 0), timezone='UTC')

• 另外，datetime 格式的字符串处理的时候转换需要标明各种各样的格式，在 Delorean 直接 parse 就可以了：

from delorean import parse
parse("2011/01/01 00:00:00 -0700")
# Delorean(datetime=datetime.datetime(2011, 1, 1, 0, 0), timezone=pytz.FixedOffset(-420))
parse("2018-05-06")
# Delorean(datetime=datetime.datetime(2018, 6, 5, 0, 0), timezone='UTC')