大数跨境

请停止使用utcnow和utcfromtimestamp

请停止使用utcnow和utcfromtimestamp Python程序员
2020-01-16
0
导读:如果您是喜欢使用UTC的开发人员,那么您可能看到过Python的datetime.utcnow()和datetime.utcfromtimestamp()方法,但遗憾的是,这并不是使用UTC date


如果您是喜欢使用UTC的开发人员,那么您可能看到过Python的datetime.utcnow()和datetime.utcfromtimestamp()方法,并且会想,“啊,是的,这就是我使用UTC应该做的事情!” 但遗憾的是,这并不是使用UTC datetime的最佳方式。事实上,我想说的是,你极少会想要使用这两个函数中的任何一个。考虑一下下面的危险代码:



当你将你的系统区域设置为UTC, 并运行这段代码时,它会成功运行,但是当你在特定时间戳偏移量非0的任何区域中执行这段代码时,其中的断言就失败——例如,当以America/New_York区域执行时,你会得到AssertionError:1571595618.0 != 1571610018.0。


这归因于一个不幸的历史怪癖和发生在Python 2到3转换中的datetime含义上的微妙转变。我想如果datetime库在今天重新设计的话,这些功能应该是不会存在的,但是目前这些功能有很多有害和无害交替的用途,想要把它们全部移除可不是件容易的事。


与其让你深挖为什么这个问题会存在的历史问题,我要破坏这个结局,并告诉你正确的做法是向now()和fromtimestamp()传递一个UTC对象,并相对地得到一个时区相关的datetime时间:



Naive datetime(不带时区)作为本地时间


最初构想时,原打算将naive(单纯)datetime设计为抽象的,不表示任何特定的时区,由程序来决定它们表示什么——这与抽象的数字没有什么不同,它们可以根据程序员的意图以千克表示质量,以米表示距离或任何其他特定的量。相比之下,aware(感知)datetime表示特定时区中的一个特定时间点。了解datetime的时区可以让你做一些事情,比如算术运算和比较时区、转换到其它时区以及其它需要具体datetime的操作。


在Python3中,有两件事情发生了变化,这使得utcnow变得不必要,而且实际上是变得危险。第一个是引入了一个具体的时区类datetime.timezone,以及一个常量UTC对象datetime.timezone.utc。有了这个更改,您现在就可以清楚而明确地标记你的datetime中的哪些是在UTC中,而无需引入第三方代码或实现你自己的UTC类。


这个改变之所以使utcnow变得危险,是因为naive(单纯)datetime在意义上发生了微妙的变化:对于某些需要将datetime解释为一个固定时间点的操作,它们会假定该datetime代表当前系统的本地时区,而不是抛出一个错误。所以在Python2中,当在naivedatetime上调用像astimezone()这样的操时会引发异常:



但在Python 3中,它将使用您系统的区域(在我的机器上是America/New_York),并相应地进行转换:



这就是为什么我在这篇文章开始使用的例子失败了。timestamp()方法会返回一个固定时间点的表示,而不是日历上的一个点;它返回的是Unix时间,这是自1970-01-01T00:00:00 UTC以来的秒数,如果您在一个naive datetime上调用它,Python将假定这个datetime表示您机器的本地时间,即使您最初打算将它设置为UTC。


结论


尽管在naive(单纯) datetime意味着什么的Python模型中没有进行更改,但我仍然建议您不要使用utcnow()或utcfromtimestamp(),仅仅是因为它是错误的抽象:这样做将把一个具体的时间点表示为一个抽象的datetime。[2]你知道你的datetime表示UTC,而且这很容易在Python中进行清楚地标记,所以你没有理由不这么做。正如它在最近添加到文档中的警告中所说的,您应该使用now来代替utcnow,使用fromtimestamp来代替utcfromtimestamp,所以请替换:



使用



或者等价地使用位置参数。


最后要注意的一点是:我们现在不能在标准库中简单地将utcnow()更改为别名now(timezone.utc)的原因是,这将改变datetime的使用者如何处理它们的语义(因此,它不会向后兼容)。在转换使用了utcnow和utcfromtimestamp的旧代码时,你应该记住这一点——您需要确保使用datetime的任何代码都期望得到一个aware(可感知的)datetime。根据我的经验,清除这两个过期的方法并不困难。您不会希望仅对未经测试的代码进行搜索和替换,之后就部署到生产环境,导致你周末不得不加班改bug。


脚注


[1] 对于那些读过我早先在pytz上发表的文章的人来说,这听起来像是一个熟悉的故事。

[2] 您可能会认为datetime.now()和datetime.fromtimestamp()也有相同的问题,因为“系统时区中的当前时间”与“UTC中的当前时间”一样具体。我基本上同意这一点,如果你想要“当前系统时间”,你可以使用dateutil.tz.tzlocal来获取一个表示它的aware(可感知的)datetime;然而,有一些边缘情况使得定义一个干净的“本地时区”对象变得不那么简单。对于UTC来说,情况要简单得多。


英文原文:https://blog.ganssle.io/articles/2019/11/utcnow.html
译者:测试

【声明】内容源于网络
0
0
Python程序员
1234
内容 2525
粉丝 0
Python程序员 1234
总阅读0
粉丝0
内容2.5k