Laravel Eloquent查询构建器如何正确比较datetime日期时间值

优先选择对传入查询参数做格式转换的方案，不建议修改模型的datetime字段类型转换配置。 #

不建议修改模型casts配置的原因 #

模型中配置'end' => 'datetime'是Laravel框架的标准用法，作用是将数据库中存储的YYYY-MM-DD HH:MM:SS格式时间字段，在读取时自动转换为Carbon时间实例，写入时自动将合法时间值转换为数据库兼容格式存储，该配置本身不会导致查询异常。

查询不生效的核心原因是：直接将原始请求参数传入where条件时，框架不会自动对参数做时间格式适配，和模型读取时的类型转换逻辑无关。如果随意修改casts配置（比如自定义序列化格式），反而会引入额外问题：

• 写入数据库时会强制按自定义格式生成SQL，在数据库时区、配置存在差异时容易存错值
• 模型输出的时间字段格式变更，会导致所有依赖该字段的业务逻辑需要适配，改造成本极高

具体实现方法 #

数据库datetime类型无法直接识别带T分隔符的ISO8601格式字符串作为比较值，只要将传入参数转换为框架能自动处理的格式即可，全程不需要修改前端传参规则、不需要调整模型配置。

推荐写法（容错性最高） #

直接将传入的ISO格式时间解析为Carbon实例，Eloquent查询构造器会自动完成格式适配，兼容所有合法时间格式（带时区、带毫秒的ISO字符串也能正常解析）：

use Carbon\Carbon;

// 解析传入的ISO格式时间参数
$after = Carbon::parse($input['after']);
// 直接传入查询即可
$events = $events->where('end', '>=', $after)->get();

轻量写法（无额外依赖） #

如果不需要处理复杂时间格式，直接替换字符串中的T为空格，转换为数据库原生识别的datetime格式即可：

$after = str_replace('T', ' ', $input['after']);
$events = $events->where('end', '>=', $after)->get();

注意事项 #

whereDate方法的设计目标就是做忽略时间维度的日期比较，只要是需要精确到时分秒的时间范围查询，直接使用基础where方法即可，不要调用whereDate/whereTime等单独提取时间部分的查询方法。 #

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