MySQL与PHP：高效判断指定时间是否落在数据库日期区间内

function is_available($date, $fullDay = false)
{
    $presenceModel = new PresenceModel(); // 假设 PresenceModel 是你的数据模型

    // 1. 统一处理输入时间：将其转换为标准的 Y-m-d H:i:s 格式
    // 这样做是为了确保无论是只传入日期还是完整时间，都能有一个统一的、可用于SQL比较的字符串
    $targetDateTime = date('Y-m-d H:i:s', strtotime($date));

    if ($fullDay) {
        // 场景一：仅比较日期（忽略时间）
        // 此时，我们只关心目标日期的“天”是否落在数据库记录的“天”之间。
        // MySQL的 DATE() 函数可以提取 DATETIME 列的日期部分。
        $presences = $presenceModel
            ->where("'$targetDateTime' BETWEEN DATE(`start`) AND DATE(`end`)")
            ->findAll();
    } else {
        // 场景二：精确比较日期和时间
        // 此时，我们关心目标完整的日期时间是否落在数据库记录的完整日期时间之间。
        // 直接比较 DATETIME 列即可。
        $presences = $presenceModel
            ->where("'$targetDateTime' BETWEEN `start` AND `end`")
            ->findAll();
    }

    return count($presences) > 0; // 返回是否存在匹配记录的布尔值
}

SELECT 1 FROM `presence`
WHERE '2021-11-02' BETWEEN DATE(`start`) AND DATE(`end`)
LIMIT 1;

SELECT 1 FROM `presence`
WHERE '2021-11-01 10:01:00' BETWEEN `start` AND `end`
LIMIT 1;

<?php

// 假设 PresenceModel 已经定义，并能够执行数据库查询
class PresenceModel {
    // 模拟数据库查询方法
    public function where($condition) {
        // 实际应用中，这里会构建SQL查询的WHERE子句
        // 为了演示，我们假设它返回一个可以链式调用的对象
        echo "Executing SQL WHERE condition: " . $condition . "\n";
        return $this;
    }

    public function findOne() {
        // 模拟执行 SELECT 1 ... LIMIT 1 并返回结果
        // 实际应用中，这里会执行数据库查询并返回一行数据或null
        echo "Executing SQL query with LIMIT 1...\n";
        // 假设找到了记录，返回一个非空值
        return (rand(0, 1) == 1) ? ['id' => 1, 'start' => '...', 'end' => '...'] : null;
    }
}

/**
 * 判断指定时间是否落在数据库日期区间内
 *
 * @param string $date 待检查的日期时间字符串 (例如 '2021-11-02' 或 '2021-11-01 10:01:00')
 * @param bool $fullDay 是否仅比较日期部分，忽略时间
 * @return bool 如果存在匹配的区间，则返回 true；否则返回 false
 */
function is_available(string $date, bool $fullDay = false): bool
{
    $presenceModel = new PresenceModel();

    // 统一处理输入时间，确保为标准的 Y-m-d H:i:s 格式
    $targetDateTime = date('Y-m-d H:i:s', strtotime($date));

    $condition = '';
    if ($fullDay) {
        // 仅比较日期部分，使用 MySQL 的 DATE() 函数
        $condition = "'$targetDateTime' BETWEEN DATE(`start`) AND DATE(`end`)";
    } else {
        // 精确比较日期和时间
        $condition = "'$targetDateTime' BETWEEN `start` AND `end`";
    }

    // 执行查询，只选择一条记录来判断是否存在
    // 在实际的ORM中，这通常对应于 first() 或 exists() 方法
    $result = $presenceModel->where($condition)->findOne();

    return $result !== null;
}

// 示例调用
echo "--- 仅比较日期（忽略时间）---\n";
echo "is_available('2021-11-02', true): " . (is_available('2021-11-02', true) ? 'true' : 'false') . "\n\n";

echo "--- 精确比较日期和时间 ---\n";
echo "is_available('2021-11-01 09:30:00'): " . (is_available('2021-11-01 09:30:00') ? 'true' : 'false') . "\n";
echo "is_available('2021-11-01 10:01:00'): " . (is_available('2021-11-01 10:01:00') ? 'true' : 'false') . "\n";
echo "is_available('2021-11-05 17:59:59'): " . (is_available('2021-11-05 17:59:59') ? 'true' : 'false') . "\n";
echo "is_available('2021-11-05 18:00:01'): " . (is_available('2021-11-05 18:00:01') ? 'true' : 'false') . "\n";

?>