Django 使用时区 详解Django 中是否使用时区的区别

起步

在 Django 的模型中新加了一个日期的字段:

import datetime
class Instance(models.Model):
  ...
  start_time = models.DateTimeField(default=datetime.datetime.now)

同步到数据库时 Django 报出了一个警告：

django/db/models/fields/__init__.py:1423: RuntimeWarning: DateTimeField Instance.start_time received a naive datetime (2018-06-14 08:59:54.761510) while time zone support is active.

这个意思是应用中开启了时区功能，而字段中却使用了 naive datetime 。我看了配置文件确实启用的时区的功能:

TIME_ZONE = 'Asia/Shanghai'
USE_TZ = True

如果设置了使用时区，那么Django在数据库中以 UTC 存储日期时间信息。

要想知道时区的 Django 中的作用，我们要先了解时间有时区的没有时区的区别。

带时区与不带时区

日期时间存在两个概念： naive time 和 aware time 。 naive time 就是不带时区的时间， aware time 则是带时区的时间。比方说， datatime.datetime.utcnow() 与 datatime.datetime.now() ，前者是 UCT 时间，后者会取机器上的本地时间，这两者呢，对于 django 来说，都是不带时区的时间（下一段会讲原因）；而使用 django.utils.timezone.now() 才是带时区的时间(aware time)。

datetime.datetime.now() 输出永远都是本地时间，与配置没有任何关系。 datatime.datetime.utcnow() 则是当前的UTC日期和时间， datetime 模块是 python 的标准库，尽管 datetime.datetime 对象有一个 tzinfo 属性可以用来存储时区信息。除非该对象设置了 tzinfo 属性，否则统统会被 django 认为是 naive time 。判断可以通过 is_naive() 来判断：

import datetime
from django.utils import timezone

print(timezone.is_naive( datetime.datetime.now() ))  # False
print(timezone.is_naive( datetime.datetime.utcnow() )) # False

显然 now() 和 utcnow() 都是没有设置 tzinfo 的。

django判断日期对象是否是原生的唯一标准就是该对象是否设置了 tzinfo

datetime 与 timezone

datetime 是标准库的模块， timezone 是 django 提供的时区的工具， timezone 其实是在 datetime 基础上进行的整合的，比方 django 中的 now 函数：

[timezone.py]
def now():
  """
  Return 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()

返回的其实也是一个 datetime 对象。

设置了 USE_TZ=True 之后

设置了 USE_TZ=True 之后，model 里面认为 DateTimeField 使用的是UTC时间（带时区的时间），这时用 datetime.datetime.now() 获取的时间是不带时区的就会报最开始说的那个警告。

并且呢， 所有的存储和内部处理，全部都是 UTC 时间 ，包括 timezone.now() ，存储也就是指数据库中存储的是UTC时间，也就只有在表单输入或模板渲染输出的时候，才会执行 UTC 到时区的转换。基本对于开发者而言，基本不用考虑本地时间的存在，所有的使用都是 UTC 时间，这也能避免手残的手动转换，尽量使用 Django 系统代劳。

若 USE_TZ=False 则所有关于时间和时区的问题都有开发人员自己把控。