Django学习笔记4 解决Django时区设置问题（从官方文档到源码）

朴灿烈づ我的快乐病毒、 2022-05-16 08:41 303阅读 0赞

# 问题背景 #

前段时间一直长期使用Django做一些项目开发，但因为时间比较紧，很多问题没有注意，比如库表中的时间戳一直使用的都是UTC时间，而在中国的话我们使用UTC+8时间才顺眼呀（比如现在是北京时间14:57那么UTC时间就是6:57）。这不是一个很大的问题，通过修改几个配置项即可完成，但是作为开发者你一定要做到对你所做的修改有了解，就像Linux经常提醒的一样“你一定要知道自己在做什么”。

# 问题现场 #

*  北京时间：2018年8月18日 19：05
 *  Django内部时间：2018年8月18日11：05  
    ![这里写图片描述][70]

# 问题分析 #

timezone.now这个函数是来自django.utils包中的，也是django的时间基础，按照目前的情况，我们django项目中所有的时间都会被影响，比如对数据库中设置了自动更新时间戳的自断进行更新操作的时候，这个时间就会默认成UTC时间。  
解决这个问题的第一想法就是在配置文件中找到相关配置去解决，我确实找到了这个参数，如下所示。  
![图1][1]

可以看出TIME\_ZONE这个参数就是导致我们这个问题的罪魁祸首了，但是我不知道该如何去正确修改这个参数，我们先去求助下官方文档。官方文档[传送们][Link 1]通过阅读官方文档我发现想解决我们的问题不仅要使用TIME\_ZONE参数而且还要使用USE\_TZ参数。我截取官方文档中的一段话来做证明。

*  原文（原为中this代表TIME\_ZONE的值）
    
    > When USE\_TZ is False, this is the time zone in which Django will store all datetimes. When USE\_TZ is True, this is the default time zone that Django will use to display datetimes in templates and to interpret datetimes entered in forms.
 *  译文  
    当**USE\_TZ**的值是**False**的时候，这个值代表Django存储所有时间所使用的时区。当**USE\_TZ**的值是**True**的时候，这个值将是Django在前端中显示与form表单中输入的默认时间所使用的时区。

大家看完这里可能还是没有理解到底该如何解决我们的这个问题，但是可以确定光通过TIME\_ZONE一个参数是无法解决问题的，还要理解USE\_TZ的用法，下面我用实验来展示下这两个参数的作用。

# 实验验证 #

实验的思路来源依旧来自官方文档关于timezones的文章[传送门][Link 2]，有兴趣的朋友可以好好读一读。  
根据上一节中官方文档对这两个参数的表述，USE\_TZ=True的时候Django的templates中会使用TIME\_ZONE的值而其他情况不会使用，当USE\_TZ=False的时候Django在所有情况下都会使用TIME\_ZONE的值。

那么下面我们就实验下使用Django templates来显示时间。关键参数的设置如下

## 实验一 ##

*  USE\_TZ=True TIME\_ZONE=Asia/Shanghai

templates代码：

{% load tz %} {% timezone None %} Paris time: { { value }} {% endtimezone %}

我们访问一下这个页面：  
![这里写图片描述][70 1]  
看到时间是2018年8月19日下午11：05和我现在的是  
![这里写图片描述][70 2]（因为访问页面的时候和截真实时间的时候有一个时间差，所以不完全一样）

现在可以证明在前端显示的时候我们所使用的时区就是我在TIME\_ZONE中设置的。但是在其他情况下呢，比如数据库中。  
正好的这个Django项目有一个User表，里面有一个字段是创建用户的时间，这个表的model如下所示。  
![这里写图片描述][70 3]  
现在我们测试一下在这个表中创建一个用户，这个add\_date字段会是什么。我们使用django的shell工具来做这些操作。

*  首先在User表中创建一条数据

![这里写图片描述][70 4]

*  之后查看现在的实际时间

![这里写图片描述][70 5]

*  最后看下库表中的时间（库表中的时间是2018年8月20日 4:47:55）

![这里写图片描述][70 6]

通过上面的实验我们也就理解了Django官方文档中对TIME\_ZONE与USE\_TZ的解释了。

# 实验二 #

为了完整性，我们在看下另外一种情况，也就是USE\_TZ=False的情况，根据文档所说所有的时间都会设置为TIME\_ZONE所在的时区。  
当前时间：  
![这里写图片描述][70 7]  
templates的时间：  
![这里写图片描述][70 8]

在向User表中添加一条数据，查看时间。  
当前时间：  
![这里写图片描述][70 9]  
数据库中的时间：  
![这里写图片描述][70 10]

## 实验总结 ##

两个实验表现了USE\_TZ=True与False的时候Django所表现的对时间的不同处理方法，现在回过头来看我的问题，就是想让库表的时间戳变成与我当地时间一致，那么我直接将USE\_TZ=False，TIME\_ZONE=我的本地时区 就可以完成了，但是这样真的好吗？对于在Asia/Shanghai这个时区的我来说这样做没有任何问题，但是如果某些开发者他们处在一个夏令时制的国家就会触发一些你无法理解的bug，Django默认给我们设置了USE\_TZ=True不是没有道理的，因为无论你身处何地，UTC时间是唯一不变的一个尺度，防止了很多莫名其妙的BUG产生，对这部分感兴趣的朋友移步官方文档仔细学习[传送门][Link 3]。

# 源码中的答案 #

在查找过官方文档后，我又去看了Django中timezone.now()的源码，其实源码表现的反而异常简单。

def now():
        """ Returns an aware or naive datetime.datetime, depending on settings.USE_TZ. """
        if settings.USE_TZ:
            # timeit shows that datetime.now(tz=utc) is 24% slower
            return datetime.utcnow().replace(tzinfo=utc)
        else:
            return datetime.now()

这里的USE\_TZ就来自于配置文件，可以看到当其值为True的时候，那么就使用utc时间，否则就使用当地时间，当然这只是一个小部分的源码，其他部分比如template对时间的实现还要仔细挖掘。

[70]: /images/20220516/a405184cfce8484882851d8392ca9000.png
[1]: /images/20220516/7a9008d456684dccaa8e69eb53f11230.png
[Link 1]: https://docs.djangoproject.com/en/1.11/ref/settings/#std:setting-TIME_ZONE
[Link 2]: https://docs.djangoproject.com/en/1.11/topics/i18n/timezones/
[70 1]: /images/20220516/2e0586fc8ebe48f9aa50147e57a064c0.png
[70 2]: /images/20220516/777588340c684acc923673f248f58950.png
[70 3]: /images/20220516/2da4353320fa43fe8a5b31a59da13df0.png
[70 4]: /images/20220516/195867ab07db400ea55e302cfdf5264f.png
[70 5]: /images/20220516/0135520d489949eba668fe28cbe87a7a.png
[70 6]: /images/20220516/f236a515297e43dea4f2be6b9569ac2f.png
[70 7]: /images/20220516/94cc737125054a8ca769ff1bc7459b30.png
[70 8]: /images/20220516/e28770d02cc34e6fa9ce9ff6d74259f9.png
[70 9]: /images/20220516/308e9cb38f4b48b2bfa9cde614c91ef1.png
[70 10]: /images/20220516/1a8f5b6c56ee467ea500e4aace5dd331.png
[Link 3]: https://docs.djangoproject.com/zh-hans/2.1/topics/i18n/timezones/