Django中带UTC感知的日期时间如何按日正确过滤？

数据库中存储的datetime对象为2024-10-26 00:49:34.131805，对应我所在时区（America/Sao_Paulo）的前一天晚上9点。当使用created_at__day=timezone.now().day按日过滤时，虽然获取到的日期是26号，但Django在过滤时会将存储的时间转换为正确时区（即前一天），最终导致匹配错误。

配置与代码 #

settings.py #

TIME_ZONE = 'America/Sao_Paulo'

USE_I18N = True

USE_TZ = True

models.py #

created_at = models.DateTimeField(auto_now_add=True)

当前查询代码 #

day = timezone.now().day
filter = Model.objects.filter(created_at__day=day)

已尝试的有效代码 #

date = timezone.now()
filter = Model.objects.filter(created_at__date=date)

这段代码可以正常工作，但我希望仅按「日」（比如匹配所有月份中的某一天，不限制年月）过滤，Django有没有对应的方法？还是我的操作有误？

问题根源 #

Django的__day查询是基于UTC时间的日部分过滤的，而非你配置的本地时区（America/Sao_Paulo）的日。存储的UTC时间是26号，但转换到本地时区是前一天，__day只会取UTC的26号去匹配，自然和本地时区的日期不对应。

按本地时区日过滤的正确方法 #

1. 过滤本地时区当天的所有记录（推荐）

如果你要查的是「今天（本地时区）的所有记录」，优先用以下两种方式：

• 方法一：构造日期范围

from django.utils import timezone
from datetime import timedelta

today = timezone.localtime(timezone.now()).date()
start = timezone.make_aware(today)
end = start + timedelta(days=1)

queryset = Model.objects.filter(created_at__gte=start, created_at__lt=end)

该方式会自动将本地时区的日期范围转换为UTC时间执行查询，确保匹配准确。

• 方法二：使用__date查询（你已验证）
  created_at__date=timezone.now()本质上是取timezone.now()对应的本地日期，然后匹配所有created_at对应本地日期等于该值的记录，这也是官方推荐的跨时区按日查询方式。

2. 过滤所有月份中的某一天（比如每月25号）

如果需求是匹配「所有年月中，本地时区日期为25号的记录」，可以用ExtractDay结合时区转换：

from django.db.models.functions import ExtractDay
from django.utils import timezone

target_day = 25
queryset = Model.objects.annotate(
    local_day=ExtractDay(timezone.localtime('created_at'))
).filter(local_day=target_day)

注意：这种方式需要对每条记录做时区转换和日提取，数据量大时性能会受影响，优先考虑日期范围查询。

总结 #

• 避免直接用__day做跨时区日过滤，它基于UTC时间，容易出现匹配偏差
• 查本地时区当天记录，用__date或构造日期范围是最可靠的方式
• 查所有月份的固定日期，用ExtractDay结合timezone.localtime处理

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