如何在 Laravel 中正确查询当前日期介于起止时间范围内的数据

本文详解 laravel eloquent 中筛选“当前时间落在数据库中两个时间字段之间”的正确写法，指出常见错误用法（如误用 where() 链式调用传递多个参数），并提供安全、高效、可读性强的解决方案。

本文详解 laravel eloquent 中筛选“当前时间落在数据库中两个时间字段之间”的正确写法，指出常见错误用法（如误用 where() 链式调用传递多个参数），并提供安全、高效、可读性强的解决方案。

在 Laravel 开发中，一个典型需求是：获取当前时间（NOW()）处于 publication_start_at 与 publication_end_at 之间的所有公告记录。但许多开发者会误将 PHP 的逻辑判断直接套用到 Eloquent 查询中，导致查询失效或报错。

例如，原始代码存在多处关键问题：

$today = date('Y-m-d H:i:s'); $official_message = OfficialMessage::all() // ❌ 错误：先加载全部数据到内存再过滤！     ->where($today, '>=', 'publication_start_at', '&&', $today, '<=', 'publication_end_at') // ❌ 语法非法：where() 不支持此参数格式     ->sortBy('publication_start_at');

⚠️ 主要问题解析

• OfficialMessage::all() 是致命性能陷阱：它会先执行 select * FROM official_messages，将全部记录载入 PHP 内存，再用 Collection 方法过滤——完全绕过数据库索引，数据量稍大即崩溃；
• where() 参数误用：Eloquent 的 where() 方法不接受 $value, $operator, $column 混合多组逻辑的写法，更不支持 ‘&&’ 这类字符串连接符；
• PHP 时间与数据库时间不同步风险：用 date(‘Y-m-d H:i:s’) 生成时间再传入查询，可能因时区、精度或服务器时间偏差导致边界判断不准。

✅ 正确做法：使用数据库原生时间函数 + 链式 where 条件

推荐使用 Eloquent 的 whereBetween() 或组合 where()，让数据库完成时间比较（高效、精准、可利用索引）：

✅ 方案一（推荐）：使用 whereRaw 调用 NOW()

use AppModelsOfficialMessage;  $messages = OfficialMessage::whereRaw('NOW() BETWEEN publication_start_at AND publication_end_at')     ->orderBy('publication_start_at')     ->get();

✅ 方案二：显式双条件（语义更清晰）

$messages = OfficialMessage::where('publication_start_at', '<=', DB::raw('NOW()'))     ->where('publication_end_at', '>=', DB::raw('NOW()'))     ->orderBy('publication_start_at')     ->get();

? 提示：DB::raw(‘NOW()’) 确保调用 mysql 的当前时间函数，避免 PHP 与数据库时区不一致；同时 WHERE 条件下推至 SQL 层，极大提升性能。

✅ 方案三（若需支持 postgresql / sqlite）：使用 now() 或 datetime(‘now’)

// PostgreSQL ->whereRaw("NOW() BETWEEN publication_start_at AND publication_end_at")  // SQLite ->whereRaw("datetime('now') BETWEEN publication_start_at AND publication_end_at")

? 注意事项与最佳实践

• ✅ 永远避免 ::all()->where(…)：这属于 N+1 反模式，应始终用 query()->get() 在数据库层过滤；
• ✅ 确保时间字段为 DATETIME 或 timestamp 类型，且索引合理（如对 publication_start_at, publication_end_at 建联合索引可进一步加速范围查询）；
• ✅ 考虑时区一致性：在 config/database.php 中配置 ‘timezone’ => ‘+00:00’，并在模型中统一使用 UTC 存储时间；
• ⚠️ 若业务要求“包含边界”，确认数据库字段是否允许 NULL；建议对 publication_end_at 设置默认值（如 9999-12-31 23:59:59）或增加非空校验。

✅ 完整修复后的控制器示例

<?php  namespace AppHttpControllers;  use AppModelsOfficialMessage; use IlluminateHttpRequest;  class MessageController extends Controller {     public function show()     {         $messages = OfficialMessage::whereRaw('NOW() BETWEEN publication_start_at AND publication_end_at')             ->orderBy('publication_start_at')             ->get();          return view('front.pages.message', [             'messages' => $messages,         ]);     } }

通过以上重构，查询从低效的内存遍历变为高效的数据库索引扫描，逻辑清晰、可维护性强，且具备良好的跨环境兼容性与时序鲁棒性。