Django 时区处理完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00531/article/details/148323761

Django 时区处理完全指南

django django/django: 是一个用于 Python 的高级 Web 框架，可以用于快速开发安全和可维护的 Web 应用程序，提供了多种内置功能和扩展库，支持多种数据库和模板引擎。项目地址: https://gitcode.com/gh_mirrors/dj/django

时区概述

在 Django 中启用时区支持后，系统会以 UTC 时间存储日期时间信息，在内部使用时区感知的 datetime 对象，并在表单中将它们转换为最终用户的本地时区。

为什么使用时区？

多时区支持：当你的用户分布在多个时区时，能够根据每个用户的本地时间显示日期时间信息
夏令时处理：即使你的网站只在一个时区运营，使用 UTC 存储数据也能避免夏令时转换带来的问题
数据一致性：UTC 时间不受地区时间调整影响，保证数据记录的准确性

默认情况下，Django 启用了时区支持。要禁用它，可以在设置文件中设置 USE_TZ = False。

核心概念

原生(Naive)与感知(Aware)的 datetime 对象

Python 的 datetime.datetime 对象有一个 tzinfo 属性，用于存储时区信息：

感知(Aware)对象：设置了 tzinfo 属性并描述了偏移量的 datetime 对象
原生(Naive)对象：没有设置 tzinfo 属性的 datetime 对象

# 检查对象类型
from django.utils import timezone

timezone.is_aware(some_datetime)  # 是否为感知对象
timezone.is_naive(some_datetime)  # 是否为原生对象

默认时区与当前时区

默认时区：由 TIME_ZONE 设置定义的时区
当前时区：用于渲染的时区

你可以使用 timezone.activate() 将当前时区设置为最终用户的实际时区。如果未设置，则使用默认时区。

时区实践

选择当前时区

大多数关心时区的网站会询问用户所在的时区，并将这些信息存储在用户配置文件中。对于匿名用户，则使用主要受众的时区或 UTC。

# 中间件示例
import zoneinfo
from django.utils import timezone

class TimezoneMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response

    def __call__(self, request):
        tzname = request.session.get("django_timezone")
        if tzname:
            timezone.activate(zoneinfo.ZoneInfo(tzname))
        else:
            timezone.deactivate()
        return self.get_response(request)

表单中的时区感知输入

启用时区支持后，Django 会在当前时区中解释表单中输入的日期时间，并在 cleaned_data 中返回感知的 datetime 对象。

模板中的时区感知输出

Django 会将感知的 datetime 对象转换为当前时区进行渲染。这类似于本地化格式。

模板标签

{% load tz %}

{# 启用/禁用转换 #}
{% localtime on %}
    {{ value }}
{% endlocaltime %}

{# 设置特定时区 #}
{% timezone "Europe/Paris" %}
    Paris time: {{ value }}
{% endtimezone %}

{# 获取当前时区 #}
{% get_current_timezone as TIME_ZONE %}

模板过滤器

{% load tz %}

{# 强制转换为当前时区 #}
{{ value|localtime }}

{# 强制转换为UTC #}
{{ value|utc }}

{# 强制转换为指定时区 #}
{{ value|timezone:"Europe/Paris" }}

迁移指南

数据库迁移

PostgreSQL：由于存储的是带时区的时间戳，可以自由切换 USE_TZ 设置
其他数据库：需要将本地时间转换为 UTC，这在夏令时转换期间可能不确定

代码迁移

在设置中添加 USE_TZ = True
重构代码，将所有 datetime 实例化为感知对象
使用 django.utils.timezone 中的辅助函数：
- now() - 获取当前感知时间
- is_aware()/is_naive() - 检查对象类型
- make_aware()/make_naive() - 转换对象类型