Spring Data日期范围对比：查询非指定区间的可用预订

是的，你确实需要编写自定义查询——现有的Spring Data派生方法没法直接满足你“找出完全不在指定日期区间内的可用预订”的需求。

为什么现有方法不适用？ #

你现有的findByStartDateBetween(Date start, Date end)和findByEndDateBetween(Date start, Date end)，是用来查询与目标区间存在重叠的预订：

• findByStartDateBetween会返回所有开始日期落在目标区间内的预订
• findByEndDateBetween会返回所有结束日期落在目标区间内的预订

但你要的是完全不重叠的预订——也就是预订的时间段和目标区间没有任何交集，这刚好是现有方法结果的补集，没法通过派生查询直接实现。

自定义查询解决方案 #

你可以在Spring Data Repository中添加带@Query注解的自定义方法，通过JPQL或原生SQL来实现需求：

方式1：JPQL查询（推荐，跨数据库兼容）

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import java.util.Date;
import java.util.List;

public interface BookingRepository extends JpaRepository<Booking, Integer> {

    @Query("SELECT b FROM Booking b WHERE b.endDate < :targetStart OR b.startDate > :targetEnd")
    List<Booking> findAvailableBookingsOutsideRange(
            @Param("targetStart") Date targetStart,
            @Param("targetEnd") Date targetEnd
    );
}

方式2：原生SQL查询（适合数据库特定场景）

如果需要使用数据库特定的日期函数（比如处理时间截断），可以用原生SQL：

@Query(value = "SELECT * FROM booking WHERE end_date < :targetStart OR start_date > :targetEnd", nativeQuery = true)
List<Booking> findAvailableBookingsOutsideRange(
        @Param("targetStart") Date targetStart,
        @Param("targetEnd") Date targetEnd
);

查询逻辑说明 #

这个查询的核心是两个互斥的条件，用OR连接：

1. b.endDate < :targetStart：预订在目标区间开始前就已经结束，完全不重叠
2. b.startDate > :targetEnd：预订在目标区间结束后才开始，完全不重叠

注意事项 #

• 如果你的日期字段包含时间部分，建议对日期进行截断处理（比如用JPA的FUNCTION('DATE', b.endDate)），避免因为时间点的差异导致判断错误（比如目标区间是2018-03-21到2018-03-25，但预订结束日期是2018-03-21 00:00:00，这时候应该算作不重叠）。
• 确保传入的Date参数格式正确，和数据库存储的日期格式匹配。

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