Django按年/月统计对象：月份过滤返回结果异常求助

这个问题我之前也碰到过，核心原因是Django时区支持下的日期字段查找逻辑和你预期的不一致。

为什么按月份过滤返回0？ #

当你的Django项目开启了USE_TZ = True（默认开启），模型中的DateTimeField是时区感知的（存储的是UTC时间，比如你示例里的+00:00）。此时使用__month、__day这类字段过滤时，Django会自动把数据库里的UTC时间转换为项目TIME_ZONE设置的本地时区，再提取月份进行匹配。

比如如果你的TIME_ZONE是某个与UTC偏移较大的时区（比如UTC+10），你那条2019-05-01 07:00:06+00:00的记录在本地时区是5月1日，但如果Django在转换或查询时出现了时区不匹配（比如数据库服务器时区和Django时区不一致），就可能导致所有记录的提取月份都不是5，最终返回0。

而按年份过滤正常，是因为年份的跨度大，UTC时间的年份和本地时区的年份几乎不会冲突（除非是跨年的边缘时刻），所以__year='2020'能正确返回5条记录。

解决方案 #

这里给你几个靠谱的解决方法，按推荐程度排序：

1. 用ORM原生函数按UTC月份过滤（推荐）

使用Django的TruncUTC和ExtractMonth函数，直接基于UTC时间提取月份，完全绕开本地时区的影响：

from django.db.models.functions import TruncUTC, ExtractMonth

# 统计UTC时间为5月的记录数量
count = Dummy.objects.annotate(
    utc_month=ExtractMonth(TruncUTC('timestamp'))
).filter(utc_month=5).count()
print(count)  # 应该返回你预期的4

或者更直观地截断到UTC月份后过滤：

from django.db.models.functions import TruncUTC

may_records = Dummy.objects.annotate(
    utc_month=TruncUTC('timestamp', 'month')
).filter(utc_month__month=5)
print(may_records.count())

2. 针对特定数据库的原生SQL查询

如果你的项目用的是PostgreSQL，可以直接用原生SQL提取UTC时区的月份：

from django.db.models import RawSQL

count = Dummy.objects.annotate(
    utc_month=RawSQL("EXTRACT(MONTH FROM timestamp AT TIME ZONE 'UTC')", [])
).filter(utc_month=5).count()

如果是MySQL，因为存储的已经是UTC时间，直接提取月份即可：

from django.db.models import RawSQL

count = Dummy.objects.annotate(
    utc_month=RawSQL("MONTH(timestamp)", [])
).filter(utc_month=5).count()

3. 临时切换时区（仅适合调试）

如果只是在shell里临时验证，可以临时把Django的时区切换为UTC：

import django.utils.timezone
from django.conf import settings

# 保存原时区
original_tz = settings.TIME_ZONE
# 切换到UTC
settings.TIME_ZONE = 'UTC'
django.utils.timezone.activate(settings.TIME_ZONE)

# 此时__month='5'会按UTC时间过滤
count = Dummy.objects.filter(timestamp__month=5).count()
print(count)

# 记得恢复原时区
settings.TIME_ZONE = original_tz
django.utils.timezone.activate(settings.TIME_ZONE)

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