whereTime()查不到数据主因是格式或时区错误：仅支持datetime/timestamp字段与Y-m-d类字符串，不支持时间戳或Carbon；时区不一致（如PHP设Asia/Shanghai而MySQL用UTC）会导致时间偏移。
ThinkPHP 的时间范围查询，本质是把字符串日期转成数据库能比对的格式，不是靠 PHP 函数硬过滤——写错格式或时区没对齐，查出来就是空的。
whereTime() 为什么查不到数据？
这是最常踩的坑：whereTime() 默认只处理 datetime 或 timestamp 类型字段，且要求传入的是「字符串格式的日期」（如 '2024-01-01'），不是 strtotime() 返回的时间戳，也不是 Carbon 实例。
- 错误写法：
whereTime('create_time', '>=', time())→ 传整数时间戳，底层会当字符串拼进 SQL，变成WHERE create_time >= '1712345678'，数据库直接类型不匹配 - 正确写法：
whereTime('create_time', '>=', '2024-01-01')或whereTime('create_time', 'between', ['2024-01-01', '2024-01-31']) - 注意：如果字段是
int类型存的时间戳，不能用whereTime()，得用where()配合strtotime()
日期区间查不到，可能是时区没对齐
ThinkPHP 默认读取 date_default_timezone_get()，但 MySQL 的 datetime 字段不带时区，而你本地 PHP 时区设成 Asia/Shanghai，MySQL 却在 UTC 下运行，'2024-01-01' 就会被解释成 UTC 时间，比你预期早 8 小时。
- 检查 MySQL 当前时区：
SELECT @@global.time_zone, @@session.time_zone; - ThinkPHP 中统一设时区：在
config/app.php加'default_timezone' => 'Asia/Shanghai' - 更稳妥的做法：用
date('Y-m-d H:i:s')生成当前时间字符串，而不是依赖now()或数据库函数
whereBetweenTime() 和 whereTime(..., 'between') 有啥区别？
没区别。前者只是后者的语法糖，底层都调用同一个解析逻辑，生成的 SQL 完全一样。别被名字误导以为它支持更多格式——它只认 Y-m-d、Y-m-d H:i:s 这两种字符串格式。
立即学习“PHP免费学习笔记（深入）”；
- 支持：
whereBetweenTime('create_time', '2024-01-01', '2024-01-31') - 不支持：
whereBetweenTime('create_time', 'last week', 'today')→ 会原样拼进 SQL，报错或查空 - 想用相对时间？先用 PHP 算好：
$start = date('Y-m-d', strtotime('-7 days'));，再传进去
用 where() 手写时间条件时，日期函数怎么选？
当字段类型不统一（比如有 int 时间戳、datetime、date），或者要嵌套数据库函数时，必须退回到 where()。
- 查
int字段：where('create_time', '>=', strtotime('2024-01-01')) - 查
date字段（只比年月日）：whereRaw("DATE(create_time) >= '2024-01-01'") - 避免
whereRaw拼接变量：用参数绑定，例如whereRaw('create_time >= ?', [$dateStr]) - 性能提醒：对
create_time字段用函数（如DATE()）会导致索引失效，能用原生字段比较就别包一层
真正麻烦的不是写法，而是你根本不知道字段存的是什么类型、MySQL 用的什么时区、PHP 又按哪个时区解析字符串——这三个地方只要一个没对上，时间范围就查不到，还很难 debug。
