如何在Django中按时间区间过滤QuerySet的DateTimeField字段？

问题背景 #

模型定义：

class Sample(models.Model):
    created_at = models.DateTimeField(auto_now_add=True, blank=True)

存储的时间示例：

2022-12-13 13:00:29.84166+08
2022-12-13 14:00:29.84166+08
2022-12-13 15:00:29.84166+08
2022-12-14 13:00:29.84166+08
2022-12-14 14:00:29.84166+08
2022-12-14 15:00:29.84166+08

需要筛选出所有日期中时间处于13:00到15:00之间的数据，此前两种写法均无效：

Sample.objects.filter(created_at__range=["13:00", "15:00"])
Sample.objects.filter(created_at__time__range=["13:00", "15:00"])

无效原因说明 #

• created_at__range=["13:00", "15:00"]：__range针对完整的DateTime范围查询，字符串"13:00"会被错误解析为日期，无法匹配每日的时间段。
• created_at__time__range=["13:00", "15:00"]：__time查询要求传入datetime.time类型对象，而非字符串，Django无法解析字符串参数导致筛选失效。

正确实现方式 #

方式一：使用datetime.time对象配合__time__range #

导入datetime模块，构造时间对象作为查询参数：

from datetime import time

# 筛选13:00（含）到15:00（含）之间的记录
Sample.objects.filter(created_at__time__range=(time(13, 0), time(15, 0)))

如果需要排除15:00整的记录，可以调整右边界为time(14, 59, 59)，确保只包含13:00-14:59:59的时间段。

方式二：通过提取小时字段筛选 #

使用annotate提取时间的小时部分，再筛选小时范围：

from django.db.models import ExtractHour

# 筛选小时为13、14、15的记录（对应13:00-15:59:59，需根据需求调整）
Sample.objects.annotate(hour=ExtractHour('created_at')).filter(hour__in=[13,14,15])

这种方式适合只按小时粗略筛选的场景，若需要精确到分钟/秒，优先使用方式一。

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