Laravel转换datetime格式时的时区自动转换问题

问题原因 #

Laravel Eloquent默认将数据库存储的时间戳当作UTC时区解析，即便你在config/app.php中设置了timezone为Europe/Brussels，它仍然会先按UTC解析库中时间，再转换为应用时区。而你的数据库实际存储的是CEST（即Europe/Brussels时区）的时间，这种解析时区的假设错误，导致最终转换后的datetime对象出现时区偏移异常。

解决方案 #

方案1：配置数据库时区（推荐）

在项目根目录的.env文件中添加数据库时区配置：

DB_TIMEZONE=Europe/Brussels

或者直接修改config/database.php中对应数据库的连接配置：

'mysql' => [
    // 保留原有配置...
    'timezone' => env('DB_TIMEZONE', 'Europe/Brussels'),
],

配置后，Laravel会明确识别数据库时间的时区，通过datetime cast转换时会直接按Europe/Brussels解析为Carbon对象，无需手动处理。

方案2：自定义Datetime Cast类

若无法修改数据库时区配置，可创建自定义Cast类强制指定解析时区：

1. 创建app/Casts/BrusselsDatetime.php文件：

<?php

namespace App\Casts;

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
use Carbon\Carbon;

class BrusselsDatetime implements CastsAttributes
{
    public function get($model, $key, $value, $attributes)
    {
        return is_null($value) ? null : Carbon::createFromFormat('Y-m-d H:i:s', $value, 'Europe/Brussels');
    }

    public function set($model, $key, $value, $attributes)
    {
        return is_null($value) ? null : Carbon::parse($value)->setTimezone('Europe/Brussels')->format('Y-m-d H:i:s');
    }
}

2. 在模型中替换原有的datetime cast为自定义类：

protected $casts = [
    'new' => \App\Casts\BrusselsDatetime::class,
];

方案3：模型内全局设置时区（快速适配）

在模型的boot方法中设置Carbon默认时区，该方法会影响模型所有datetime字段的解析：

protected static function boot()
{
    parent::boot();

    \Carbon\Carbon::setDefaultTimezone('Europe/Brussels');
}

注意：若模型存在需要按UTC解析的字段，不建议使用此方法。

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