在Laravel开发中，我们经常需要对数据表中的时间字段进行部分匹配查询，比如查询某一天的所有数据、某个小时的所有记录，或者匹配特定分钟的数据。Eloquent提供的Where Time方法可以很方便地实现这类时间部分匹配的需求，不需要手动拼接复杂的时间字符串。
Where Time方法基本用法
Where Time方法用于比较时间字段的时间部分，默认情况下会提取时间字段的时分秒部分进行匹配，也可以指定具体的时间格式来匹配对应的部分。
查询特定小时的数据
如果需要查询某个小时内的所有记录，比如查询10点之后的所有数据，可以使用如下代码：
<?php
// 查询create_time字段时间部分为10点之后的所有用户记录
$users = User::whereTime('create_time', '>=', '10:00:00')->get();
// 查询create_time字段时间部分为8点到12点之间的记录
$users = User::whereTime('create_time', '>=', '08:00:00')
->whereTime('create_time', '<=', '12:00:00')
->get();
查询特定日期的数据
如果需要查询某一天的所有数据，可以结合whereDate方法和whereTime方法，也可以直接使用whereTime匹配日期部分，示例代码如下：
<?php
// 方法1：使用whereDate匹配日期
$users = User::whereDate('create_time', '2024-05-20')->get();
// 方法2：使用whereTime匹配日期部分（需要指定格式）
$users = User::whereTime('create_time', '=', '2024-05-20', 'Y-m-d')->get();
时间部分匹配的常见场景
匹配特定分钟的数据
如果需要查询分钟部分为30的所有记录，比如10:30:xx、12:30:xx这类数据，可以使用如下方式：
<?php
// 使用MySQL的TIME_FORMAT函数提取分钟部分进行匹配
$users = User::whereRaw("TIME_FORMAT(create_time, '%i') = ?", ['30'])->get();
查询当前小时的数据
实际开发中经常需要查询当前小时产生的数据，可以结合Carbon时间类来实现：
<?php
use CarbonCarbon;
$currentHour = Carbon::now()->format('H');
$users = User::whereTime('create_time', '>=', $currentHour.':00:00')
->whereTime('create_time', '<', ($currentHour + 1).':00:00')
->get();
注意事项
- 使用whereTime方法时，时间字段需要是数据库中的datetime、timestamp等时间类型，否则可能无法正确匹配。
- 如果数据库存储的是UTC时间，需要先转换时区再查询，避免出现时间偏差。
- whereTime方法的时间比较默认是字符串比较，因此需要保证传入的时间格式和数据库存储的时间格式一致。
- 复杂的自定义时间格式匹配可以结合whereRaw方法使用原生SQL函数，比如DATE_FORMAT、TIME_FORMAT等。
总结
Eloquent的Where Time方法为Laravel中的时间部分查询提供了便捷的封装，开发者可以根据不同的需求选择对应的匹配方式。对于简单的小时、日期匹配可以直接使用whereTime，对于复杂的时间格式匹配可以结合原生SQL函数实现。掌握这些方法可以让时间查询的代码更简洁，也减少手动拼接SQL带来的错误风险。
PHPEloquentLaravelWhere_Time时间查询修改时间：2026-07-04 00:33:11