Django 2.1.4：filter按年份筛选为何返回空QuerySet？

这个坑我踩过！问题大概率出在Django的时区处理差异上，咱们来拆解清楚：

核心矛盾：数据库查询与时区转换的不一致 #

当你设置USE_TZ=True（Django默认开启）时：

• auto_now_add=True的DateTimeField会把UTC时间存储到数据库中
• 当你在Python代码中访问el.created.year时，Django会自动将UTC时间转换为你在settings.py中设置的TIME_ZONE（比如Asia/Shanghai），所以得到的是本地时区的年份
• 但用created__year=2014查询时，是直接在数据库层面对存储的UTC时间取年份过滤，这就可能出现偏差：比如一篇文章在本地时区是2014年1月1日凌晨1点，但UTC时间还是2013年12月31日，数据库里存的是UTC时间，所以查询2014年返回空，但Python层面转时区后年份是2014。

验证方法 #

你可以先验证这个时区差异：

• 打印数据库中存储的原始UTC时间：

  print(Article.objects.values('created').first())
  

• 再打印Python层面转换后的时间：

  obj = Article.objects.first()
  print(obj.created, obj.created.year)
  

对比两者的年份，就能确认是不是时区导致的问题。

解决办法 #

根据你的需求，有两种可靠的解决方式：

方式一：用带时区的时间范围查询 #

直接构造本地时区的时间区间，Django会自动处理时区转换，确保数据库查询和Python判断逻辑一致：

from datetime import datetime
from django.utils import timezone

# 构造本地时区的2014年起始和结束时间
start_of_2014 = timezone.make_aware(datetime(2014, 1, 1))
end_of_2014 = timezone.make_aware(datetime(2015, 1, 1))

# 用范围查询替代year过滤
articles = Article.objects.filter(created__gte=start_of_2014, created__lt=end_of_2014)

方式二：在查询时转换时区后提取年份 #

使用Django的数据库函数，先将UTC时间转换为本地时区，再提取年份进行过滤：

from django.db.models.functions import ExtractYear
from django.db.models import F
from django.utils.timezone import localtime

articles = Article.objects.annotate(
    local_created_year=ExtractYear(localtime(F('created')))
).filter(local_created_year=2014)

不推荐的方案（仅适合单时区场景） #

如果你的应用完全不需要跨时区支持，可以在settings.py中设置：

USE_TZ = False

这样数据库会直接存储本地时区的时间，created__year查询就会和Python层面的判断一致，但这种方式不适合生产环境或跨时区应用。

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