Django ORM筛选datetime时识别'Z'偏移但不识别'+0000'偏移问题

核心原因 #

你遇到的问题本质是字段类型误用：用CharField存储ISO-8601格式的日期时间字符串，而非Django原生的DateTimeField。

当使用createddate__date筛选时，Django会生成SQL指令让数据库直接将字符串转换为日期类型。但MySQL的日期转换函数（如STR_TO_DATE）对ISO-8601的后缀支持不统一：它能识别'Z'作为UTC标记，但无法正确解析'+0000'格式的偏移量，导致带'+0000'的数据无法被匹配。

另外，虽然Django的日期解析逻辑本身可以处理'Z'和'+0000'两种格式，但CharField不会触发Django的内置解析，完全依赖数据库的转换能力，这就导致了筛选结果不一致。

解决方案 #

方案一：修正字段类型（推荐） #

这是最规范的解决方式，彻底解决数据存储类型不匹配的问题：

1. 备份数据库，避免数据丢失。
2. 临时添加字段并迁移数据：
   在models.py中新增一个临时的DateTimeField：

   temp_createddate = models.DateTimeField(blank=True, null=True)
   

   生成并执行迁移：

   python manage.py makemigrations
   python manage.py migrate
   

   然后编写脚本将现有createddate的字符串转换为datetime对象存入临时字段（Python可以正确解析两种后缀）：

   from datetime import datetime
   from myapp.models import Receipt
   
   for receipt in Receipt.objects.all():
       if receipt.createddate:
           # Python的datetime.fromisoformat可以处理Z和+0000
           receipt.temp_createddate = datetime.fromisoformat(receipt.createddate.replace('Z', '+00:00'))
           receipt.save()
   

3. 替换原字段：删除原createddate字段，将temp_createddate重命名为createddate，并指定db_column='CreatedDate'，再次生成迁移并执行。
4. 验证功能：此时使用Receipt.objects.filter(createddate__date='2025-01-20').count()即可正确匹配所有数据。

方案二：不修改字段类型的临时适配（适合无法修改数据库结构的场景） #

利用Django的Func和Cast函数，在查询时统一转换字符串格式：

from django.db.models import Func, Value
from django.db.models.fields import DateTimeField
from django.db.models.functions import Cast

# 先将所有+0000替换为Z，再转换为DateTime类型
queryset = Receipt.objects.annotate(
    parsed_created=Cast(
        Func('createddate', Value('+0000'), Value('Z'), function='REPLACE'),
        output_field=DateTimeField()
    )
).filter(parsed_created__date='2025-01-20')

count = queryset.count()

这个方法通过MySQL的REPLACE函数统一格式后，再转换为日期类型进行筛选，能兼容两种后缀的字符串。

内容的提问来源于stack exchange，提问作者Ryan Vande Water