Django分离日期时间字段下如何实现条件order_by查询

问题背景 #

现有Meeting模型将会议日期和时间分离存储，meeting_time允许为null（无法用单个DateTimeField区分无时间信息和实际设置为00:00的会议），需要实现获取当前时间之前的最新会议的查询，核心难点是实现条件排序：先按日期降序，再按「会议时间是否≤当前时间」排序（符合条件的优先），最后按时间降序。

模型定义 #

class Meeting(models.Model):
    meeting_date = models.DateField(db_index=True)
    meeting_time = models.TimeField(db_index=True, null=True, blank=True)

解决方案 #

利用Django ORM的Case/When构造条件排序字段，结合annotate和order_by实现需求，同时处理时区和meeting_time为null的场景：

from datetime import datetime
from django.db.models import Case, When, BooleanField, Value, Q
from django.utils.timezone import make_aware

# 若项目启用时区，必须使用时区感知时间
now = make_aware(datetime.now())
now_date = now.date()
now_time = now.time()

# 1. 筛选当前时间之前的会议：
#    - 日期早于今天，或
#    - 日期等于今天，且（时间≤当前时间 或 无具体时间）
filtered_meetings = Meeting.objects.filter(
    Q(meeting_date__lt=now_date) |
    Q(
        meeting_date=now_date,
        Q(meeting_time__lte=now_time) | Q(meeting_time__isnull=True)
    )
)

# 2. 标注符合时间条件的会议，用于排序
sorted_meetings = filtered_meetings.annotate(
    is_eligible=Case(
        When(meeting_date__lt=now_date, then=Value(True)),
        When(
            meeting_date=now_date,
            Q(meeting_time__lte=now_time) | Q(meeting_time__isnull=True),
            then=Value(True)
        ),
        default=Value(False),
        output_field=BooleanField()
    )
)

# 3. 按规则排序，取第一个结果
prev_meeting = sorted_meetings.order_by(
    '-meeting_date',   # 日期从新到旧
    '-is_eligible',    # 符合时间条件的优先排在前面
    '-meeting_time'    # 同一日期内，时间从晚到早
).first()

关键细节说明 #

1. 筛选逻辑：确保只保留当前时间之前的会议，其中无具体时间的会议视为全天有效，符合筛选条件。
2. 条件排序：通过annotate创建is_eligible字段标记符合时间要求的会议，排序时让这些会议优先展示。
3. 时区处理：若项目启用USE_TZ = True，必须用make_aware将本地时间转为时区感知时间，避免时间不一致问题。
4. 空时间排序优化：如果希望无具体时间的会议在同一天的排序中排在有时间的会议之后，可以额外构造排序用的时间字段：

   from django.db import models
   
   sorted_meetings = filtered_meetings.annotate(
       sorted_time=Case(
           When(meeting_time__isnull=True, then=Value('23:59:59')),
           default='meeting_time',
           output_field=models.TimeField()
       ),
       is_eligible=Case(...)  # 保留之前的标注
   )
   prev_meeting = sorted_meetings.order_by('-meeting_date', '-is_eligible', '-sorted_time').first()
   

原写法问题说明 #

直接在order_by中使用f字符串（如f'meeting_time <= {now.time()}'）不符合Django ORM规范，ORM的order_by仅接受字段名或合法的表达式，必须通过Case/When构造条件排序逻辑。

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