如何在Laravel中查询指定日期区间内可租赁的可用车辆

这个问题其实核心是判断车辆的现有租赁记录和目标日期区间是否存在重叠，只要排除掉有重叠的车辆，剩下的就是可用的。我在Laravel项目里处理过类似的场景，给你分享两种简洁且覆盖所有边界情况的实现方式：

首先确保你的Car和Rental模型已经建立了正确的关联：

// app/Models/Car.php
class Car extends Model
{
    public function rentals()
    {
        return $this->hasMany(Rental::class);
    }
}

// app/Models/Rental.php
class Rental extends Model
{
    public function car()
    {
        return $this->belongsTo(Car::class);
    }
}

两个日期区间（现有租赁区间[r_start, r_end]和目标区间[target_start, target_end]）存在重叠的唯一判断条件是：

r_start < target_end AND r_end > target_start

这个条件可以覆盖所有可能的重叠场景：

• 现有租赁完全包含目标区间
• 目标区间完全包含现有租赁
• 现有租赁的开始/结束时间落在目标区间内
• 两个区间部分重叠

用这个条件代替拆分四种场景的写法，代码更简洁且不易出错。

方式一：使用whereDoesntExist（推荐，性能更优） #

这种方式会查询出没有任何重叠租赁记录的车辆，是Laravel中处理这类排除查询的最优写法：

use Carbon\Carbon;
use Illuminate\Support\Facades\DB;
use App\Models\Car;

// 目标日期区间（根据实际需求替换）
$targetStart = Carbon::parse('2018-02-20');
$targetEnd = Carbon::parse('2018-02-23');

$availableCars = Car::whereDoesntExist(function ($query) use ($targetStart, $targetEnd) {
    $query->select(DB::raw(1))
          ->from('rentals')
          ->whereColumn('rentals.car_id', 'cars.id')
          // 核心重叠判断条件
          ->where('rentals.start_date', '<', $targetEnd)
          ->where('rentals.end_date', '>', $targetStart);
})->get();

方式二：使用左连接筛选 #

如果你更习惯用连接查询，也可以通过左连接后筛选无关联记录的方式实现：

$availableCars = Car::leftJoin('rentals', function ($join) use ($targetStart, $targetEnd) {
    $join->on('cars.id', '=', 'rentals.car_id')
         ->where('rentals.start_date', '<', $targetEnd)
         ->where('rentals.end_date', '>', $targetStart);
})
->whereNull('rentals.id') // 筛选出没有重叠租赁的车辆
->select('cars.*') // 只返回车辆表的字段
->get();

为了方便在项目中多次调用，可以把这个查询逻辑封装到Car模型的静态方法里：

// app/Models/Car.php
public static function availableBetween($startDate, $endDate)
{
    // 确保传入的日期是Carbon实例，避免格式问题
    $start = Carbon::parse($startDate);
    $end = Carbon::parse($endDate);

    return self::whereDoesntExist(function ($query) use ($start, $end) {
        $query->select(DB::raw(1))
              ->from('rentals')
              ->whereColumn('rentals.car_id', 'cars.id')
              ->where('rentals.start_date', '<', $end)
              ->where('rentals.end_date', '>', $start);
    });
}

之后在控制器或其他地方调用就非常简洁：

$availableCars = Car::availableBetween('2018-02-20', '2018-02-23')->get();

• 日期字段类型：确保rentals表中的start_date和end_date字段是date、datetime或timestamp类型，避免字符串格式不匹配导致的查询错误。
• 边界调整：如果你的业务允许车辆在租赁结束当天被再次租赁（比如租赁到23号，用户从23号开始租），可以把条件调整为rentals.end_date >= $start和rentals.start_date <= $end，具体根据业务规则来定。
• 时间精度：如果使用datetime类型，记得考虑时间部分（比如用户的目标区间是否包含当天23:59），Carbon默认会解析到当天00:00，需要的话可以手动设置时间：Carbon::parse('2018-02-23 23:59:59')。

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