Python/Django 中如何编写Query检测两个日期字段区间是否重叠

核心逻辑 #

首先明确两个闭日期区间 [s1, e1]（数据库已有记录）和 [s2, e2]（新提交数据）存在重叠的充要条件：
s1 <= e2 AND s2 <= e1
所有重叠场景都会命中该条件，完全覆盖你列出的4种重叠情况，不会漏判。

具体实现代码 #

假设你的对应模型命名为ValidPeriod，两个日期字段为valid_start、valid_end，在Serializer中重写validate方法实现校验：

from rest_framework import serializers
from .models import ValidPeriod
from django.db.models import Q

class ValidPeriodSerializer(serializers.ModelSerializer):
    class Meta:
        model = ValidPeriod
        fields = "__all__"
    
    def validate(self, attrs):
        # 基础校验：开始日期不能晚于结束日期
        valid_start = attrs.get("valid_start")
        valid_end = attrs.get("valid_end")
        if valid_start > valid_end:
            raise serializers.ValidationError("生效开始日期不能晚于生效结束日期")
        
        # 构造重叠查询条件
        overlap_query = Q(valid_start__lte=valid_end) & Q(valid_end__gte=valid_start)
        
        # 更新操作需排除当前修改的记录，避免自己和自己校验冲突
        if self.instance:
            overlap_exists = ValidPeriod.objects.filter(overlap_query).exclude(pk=self.instance.pk).exists()
        else:
            # 新增操作直接查询全量记录
            overlap_exists = ValidPeriod.objects.filter(overlap_query).exists()
        
        if overlap_exists:
            raise serializers.ValidationError("提交的生效日期区间与已有记录存在重叠")
        
        return attrs

适配说明 #

• 如果你的日期区间是左闭右开规则（比如结束日期当天不生效），把查询条件里的lte改成lt、gte改成gt即可
• 如果是DateTime类型字段，需要确保提交的时间和数据库存储的时区一致，避免时区差导致的校验误差
• 调用exists()方法做存在性判断效率最优，不需要返回完整记录即可完成校验

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