carbon 是 laravel 开箱即用的日期处理核心，模型时间字段默认为 carbon 实例；若调用 format() 报错，说明字段未被自动转换，需检查数据库类型、$casts 或 $dates 配置；推荐使用 todatestring() 等语义方法替代 format()；存 utc、展示时再转时区；查询用 wherebetween 而非字符串比较。
Carbon 在 Laravel 里不是“要学怎么装”的第三方库，而是开箱即用的日期处理核心——created_at、updated_at 甚至你声明过 $casts 或 $dates 的字段，读出来就是 Carbon 实例，直接调方法就行。
模型字段直接调用 format() 就报错？先看是不是 Carbon 实例
常见错误现象：Call to a member function format() on string
这说明你访问的字段没被 Laravel 自动转成 Carbon，比如：
- 数据库字段类型是
TEXT或VARCHAR，不是DATETIME/TIMESTAMP - 模型里没在
$casts中声明该字段（Laravel 9+ 推荐）或没加进$dates（旧写法） - 手动从数组/JSON 取值，绕过了 Eloquent 的自动转换逻辑
解决办法：确认字段已正确 cast，例如：
protected $casts = [
'event_start' => 'datetime',
'published_at' => 'datetime:Y-m-d H:i:s',
];
如果字段确实只是字符串，再用 Carbon::parse($string) 转一次，别硬调 format()。
format('Y-m-d') 和 toDateString() 选哪个？
format() 灵活但易错；toDateString() 等语义方法更安全、不易拼错，且返回值类型明确。
-
format('Y-m-d')：支持全部 PHP 格式符，但大小写敏感（y是两位年，Y是四位年），返回字符串 -
toDateString()：固定返回Y-m-d格式字符串，不接受参数，适合简单日期展示 -
toDateTimeString()、toISOString()、toFormattedDateString()同理，各司其职 - 所有这些方法都不修改原实例，是只读操作
别用 format('Y年m月d日') 直接输出中文——它不可本地化，也不利于后续解析；真要中文展示，建议前端处理或用 Carbon::now()->translatedFormat('Y年m月d日')（需配置 locale）。
时区混乱导致时间差 8 小时？统一用 UTC 存 + 应用层转
关键点：数据库存 UTC 是最佳实践，Laravel 默认也这么做（前提是 MySQL time_zone 设置为 +00:00 或 UTC）。
-
$date->utc()：把当前实例强制转为 UTC（值会变），适合入库前归一 -
$date->timezone('Asia/Shanghai')：显式切换并换算时间值，适合用户侧展示 -
$date->local()：仅改变时区标签，不换算时间值，容易引发误解，慎用 - 跨时区比较前，务必先统一时区：
$start->tz('UTC')->lt($end->tz('UTC'))
别依赖服务器本地时区；config/app.php 中的 'timezone' => 'Asia/Shanghai' 只影响 Carbon::now() 默认行为，不影响数据库读取逻辑。
查 created_at 在两个日期之间？用 whereBetween 而不是手写字符串
错误做法：where('created_at', '>=', '2024-01-01 00:00:00')->where('created_at', '
问题：字符串比较不可靠，且忽略时区、精度（如毫秒）、索引优化。
- 正确写法：
whereBetween('created_at', [$start->startOfDay(), $end->endOfDay()]) -
$start->startOfDay()返回当天 00:00:00.000000（含微秒），endOfDay()返回 23:59:59.999999 - 如果查询参数来自用户输入（如表单字符串），先用
Carbon::parse($input)->startOfDay()转，避免格式错误 - MySQL 若未启用微秒精度（
DATETIME(6)），endOfDay()的 .999999 会被截断，实际查到的是 23:59:59 —— 这时改用addDay()->subSecond()更稳妥
真正容易被忽略的是：whereBetween 本身不处理时区，传进去的 Carbon 实例必须已经是目标时区（通常是 UTC），否则范围会偏移。
