Django项目中如何将数据库已存储的naive datetime转换为时区感知类型

存量naive datetime数据处理方案 #

以下按不同场景对应处理方式如下： #

场景1：使用非PostgreSQL数据库，且存量naive datetime本身为UTC时间

无需对存量数据做任何额外修改。
非PostgreSQL数据库本身不存储时区信息，Django开启时区支持后，读取到的naive UTC时间会默认被识别为UTC时区的合法时间，后续不会再触发RuntimeWarning警告，也不会出现时间偏移错误。 #

场景2：使用非PostgreSQL数据库，存量naive datetime为本地时区时间

需要通过数据迁移将存量时间统一转换为UTC时间，操作步骤如下：

• 操作前先对全量数据库做备份，避免操作失误导致数据损坏
• 执行命令生成空迁移文件：python manage.py makemigrations --empty 你的应用名称
• 编辑生成的迁移文件，添加存量时间转换逻辑，示例代码如下：

from django.db import migrations
import pytz

def convert_local_naive_to_utc(apps, schema_editor):
    # 替换为你实际的模型所属应用名、模型名
    TargetModel = apps.get_model('你的应用名称', '你的模型名')
    # 替换为你项目实际使用的本地时区，示例为上海时区
    local_tz = pytz.timezone('Asia/Shanghai')
    for item in TargetModel.objects.all():
        # 给naive本地时间添加时区标识，转换为UTC时间存储
        local_with_tz = local_tz.localize(item.time_sent, is_dst=None)
        item.time_sent = local_with_tz.astimezone(pytz.UTC)
        item.save()

class Migration(migrations.Migration):
    dependencies = [
        # 替换为上一次的上一个迁移文件的标识
        ('你的应用名称', 'xxxx_previous_migration_id'),
    ]

    operations = [
        migrations.RunPython(convert_local_naive_to_utc),
    ]

• 先在测试环境执行迁移验证时间转换结果无误后，再到生产环境执行迁移操作

场景3：使用PostgreSQL数据库

• 若存量naive datetime本身为UTC时间：直接修改模型对应字段定义为time_sent = models.DateTimeField(default=timezone.now, blank=True, timezone=True)，生成并执行迁移即可，PostgreSQL会自动给存量时间添加UTC时区标识。
• 若存量naive datetime为本地时区时间：先按照场景2的逻辑完成存量时间到UTC的转换，再修改字段添加timezone=True属性执行迁移。

注意：所有涉及存量数据修改的操作，必须先备份再执行，避免数据丢失

内容的提问来源于stack exchange，提问作者Surya Banerjee