Laravel Carbon插入时丢失毫秒精度的全局解决方法

数据库里有个timestamp(6)类型的date列，用Laravel的Model::insert()（底层是Query Builder，绕开了Eloquent）插数据时，时间戳的毫秒精度会丢失。比如执行这段代码：

Item::insert(['date' => Carbon\Carbon::parse('2023-01-24T02:02:02.222222Z')]);

数据库存的时间戳会变成2023-01-24T02:02:02.000000Z，毫秒部分全被清成0了。手动把Carbon对象转成带毫秒的字符串能解决，但每次都这么写太麻烦，想找个全局生效的办法。

已知Carbon的__toString()默认只输出秒级精度，旧的setToStringFormat()方法已经废弃，直接改CarbonInterface.php里的常量源码又不合适。现在想让项目里所有日期时间都保留毫秒精度，该怎么实现？

环境信息：

• MySQL 5.7.37
• Laravel 8.83.23
• PHP 8.1

方法1：全局设置Carbon的字符串输出格式 #

在AppServiceProvider的boot()方法里配置Carbon的全局字符串格式，用官方推荐的替代方案（Laravel 8对应Carbon版本支持useToStringFormat）：

// app/Providers/AppServiceProvider.php
use Carbon\Carbon;

public function boot()
{
    // 全局设置Carbon转字符串时保留微秒
    Carbon::useToStringFormat('Y-m-d H:i:s.u');
}

这样所有Carbon对象转成字符串时都会带上微秒，Query Builder插入数据时自然就能保留毫秒精度了。

方法2：自定义Carbon子类替换全局实例 #

如果不想直接修改Carbon的默认行为，可以自己写个Carbon子类，重写__toString方法，再全局替换：

1. 创建自定义Carbon类：

// app/Carbon/CustomCarbon.php
namespace App\Carbon;

use Carbon\Carbon as BaseCarbon;

class CustomCarbon extends BaseCarbon
{
    public function __toString()
    {
        // 输出带微秒的格式
        return $this->format('Y-m-d H:i:s.u');
    }
}

2. 在AppServiceProvider中替换全局Carbon实例：

// app/Providers/AppServiceProvider.php
use App\Carbon\CustomCarbon;
use Carbon\Carbon;

public function boot()
{
    Carbon::swap(CustomCarbon::class);
}

之后项目里所有Carbon实例都会用这个自定义类的__toString方法，确保时间戳带毫秒。

方法3：配合Laravel日期配置（辅助方案） #

如果同时要兼顾Eloquent的日期处理，可以在config/app.php里修改全局日期格式：

// config/app.php
'date_format' => 'Y-m-d H:i:s.u',

这个配置主要影响Eloquent模型的日期序列化，和方法1配合使用，能覆盖Query Builder和Eloquent两种场景的精度保留需求。

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