如何在Django QuerySet中正确使用__time查询？

咱们先拆解你遇到的问题根源：你的start_date字段是带Africa/Harare时区（CAT+2）的DateTime对象，而你用来对比的datetime.time(17,30)是无时区感知的时间对象，这种时区不匹配直接导致数据库层面的对比逻辑错位，最终出现筛选结果不符合预期的情况。

问题重现回顾 #

你的模型定义：

class Booking(models.Model):
    start_date = models.DateTimeField()
    end_date = models.DateTimeField()
    # 其他字段...

测试数据里的所有记录都绑定了CAT时区，比如16:30 CAT实际对应14:30 UTC，17:30 CAT对应15:30 UTC。

你最初的错误查询：

# 这里的datetime.time()是无时区的datetime.time(17,30)
bookings = Booking.objects.filter(start_date__time__lte=datetime.time(17,30))

返回空结果，而用__gte却返回所有4条记录，本质是无时区时间和带时区字段的对比逻辑出现了反转。

__time 查询的正确使用方式 #

要让__time查询正常工作，核心是保证对比的时间对象和数据库字段的时区规则一致，分两种场景处理：

1. 项目开启时区支持（USE_TZ=True） #

如果你的Django项目配置了USE_TZ=True（也就是数据库存储的是UTC时间，字段是带时区感知的DateTime），有两种正确做法：

• 方法一：创建带对应时区的时间对象

from django.utils import timezone
import pytz

# 获取目标时区
tz = pytz.timezone('Africa/Harare')
# 创建带时区的17:30时间对象
target_time = timezone.make_aware(datetime.datetime(2018,5,8,17,30), tz).time()

# 正确执行筛选
bookings = Booking.objects.filter(start_date__time__lte=target_time)

• 方法二：转换为UTC时间对比
  因为数据库存储的是UTC时间，你可以直接把目标时间转换成UTC的对应值：

# 17:30 CAT = 15:30 UTC
target_utc_time = datetime.time(15,30)
bookings = Booking.objects.filter(start_date__time__lte=target_utc_time)

2. 项目未开启时区支持（USE_TZ=False） #

如果你的项目没有启用时区功能，直接用普通的datetime.time对象对比即可，不需要额外处理时区：

target_time = datetime.time(17,30)
bookings = Booking.objects.filter(start_date__time__lte=target_time)

补充：结合日期筛选的场景 #

如果你需要同时筛选同一天+时间≤17:30的记录，除了你用的Q组合查询，也可以用更简洁的链式筛选：

target_date = datetime.date(2018,5,8)
# 带时区的情况记得给时间绑定对应时区
target_time = timezone.make_aware(datetime.datetime(2018,5,8,17,30), pytz.timezone('Africa/Harare')).time()

bookings = Booking.objects.filter(
    start_date__date=target_date,
    start_date__time__lte=target_time
)

为什么你之前的查询失效？ #

当字段带时区，而对比的时间无时区时，Django会默认把你的本地时间（无时区）当作UTC时间来处理。比如你用17:30无时区时间，数据库会把它当成17:30 UTC，而你的记录里的17:30 CAT实际是15:30 UTC，15:30 UTC < 17:30 UTC，理论上应该匹配，但实际因为时区转换的逻辑偏差，导致对比逻辑反转，最终返回空结果；而__gte则会包含所有记录，因为所有记录的UTC时间都早于17:30 UTC。

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