whereTime查不到数据主因是时区未对齐，非时间格式问题；数据库存UTC而PHP配东八区时，条件会被错误转换，应统一时区或改用时间戳+whereBetween确保索引生效。
whereTime 用不对，查不到数据不是时间格式问题，是时区没对齐
ThinkPHP 的 whereTime 看似方便，但默认按服务器本地时区解析字符串。如果你数据库存的是 UTC 时间（比如 MySQL 默认时区为 +00:00），而 PHP 配置了 date.timezone = Asia/Shanghai，那 whereTime('create_time', 'between', ['2024-01-01', '2024-01-31']) 实际生成的 SQL 会把起止时间自动转成东八区时间再比较，结果就是「明明有数据却查不出来」。
- 查前先确认数据库字段类型：如果是
DATETIME且无时区信息，就老老实实按数据库所在时区写条件；如果是TIMESTAMP，它本身会自动转时区，这时更推荐用whereBetween手动传时间戳 - 避免依赖字符串自动解析，直接用
strtotime()或Carbon::parse()->timestamp转成整数再传给whereBetween - 调试时打开 SQL 日志，看最终生成的 WHERE 条件里时间值是不是你预期的
whereBetween 传字符串 vs 传时间戳，性能差一倍不止
用 whereBetween('create_time', ['2024-01-01', '2024-01-31']) 看着简洁，但 ThinkPHP 会在底层调用 strtotime 多次转换，还可能触发隐式类型转换。MySQL 对 DATETIME 字段做字符串范围查询时，如果字段没索引或索引失效，很容易全表扫描。
- 优先传时间戳：
whereBetween('create_time', [1704067200, 1706745599])，绕过框架解析，SQL 直接走索引 - 确保
create_time字段建了 B-tree 索引；如果是联合索引，注意字段顺序，时间字段别放在联合索引末尾 - 不要在 where 条件里对字段做函数操作，比如
whereRaw('DATE(create_time) = ?', ['2024-01-01'])，这会让索引完全失效
模型时间自动写入和查询不一致？检查 $autoWrite 和 $dateFormat
模型设置了 protected $autoWrite = true，又配了 protected $dateFormat = 'Y-m-d H:i:s'，看起来很规范。但问题常出在：写入用的是当前 PHP 时间，查询时却拿字符串去比，而数据库里存的可能是带毫秒、或格式不统一的值（比如 Laravel 迁移来的数据）。
-
$dateFormat只影响写入和读取时的格式化，不影响查询条件解析；查区间必须自己控制精度 - 如果业务要求精确到秒，写入前用
date('Y-m-d H:i:s')截断毫秒，否则whereTime可能漏掉最后几条 - MySQL 8.0+ 支持
DATETIME(3)，但 ThinkPHP 默认不识别毫秒，建议统一用秒级存储，省去兼容成本
跨天查询凌晨数据总少几条？小心 MySQL 的 DATETIME 比较陷阱
比如查「昨天 00:00 到今天 00:00」，写成 whereBetween('create_time', ['2024-05-14 00:00:00', '2024-05-15 00:00:00'])，看似没问题。但 MySQL 的 BETWEEN 是闭区间，而 '2024-05-15 00:00:00' 这个时间点本身不会被包含——因为 DATETIME 类型最小单位是秒，00:00:00 表示的是当天第一秒开始的瞬间，严格来说「等于」这个值的数据极少。
立即学习“PHP免费学习笔记（深入）”；
- 改成开区间更稳妥：
where('create_time', '>=', '2024-05-14 00:00:00')->where('create_time', ' - 或者用时间戳算好边界：
whereBetween('create_time', [$startTs, $endTs - 1])，避免踩BETWEEN的语义坑 - 线上排查时，用
SELECT MIN(create_time), MAX(create_time) FROM table WHERE ...看实际数据边界，别只信逻辑推算
时间查询最麻烦的从来不是语法，而是「你以为的时间」和「数据库存的时间」、「PHP 解析的时间」、「MySQL 比较的时间」这四者之间差的那几个小时、几毫秒、甚至是否自动补零。动手前，先用 SELECT NOW(), @@time_zone, @@system_time_zone 看清环境底细。
