Laravel中Carbon转换指定时区日期至UTC无变化问题排查

问题根源 #

你的输入时间字符串2023-05-13T12:00:00.000Z末尾的Z是UTC时区的标识，Carbon在解析这类带时区信息的字符串时，会优先使用字符串自带的时区，直接忽略你传入的Europe/Amsterdam参数。这就导致你实例化的Carbon对象本身就是UTC时间12:00，后续调用setTimezone('UTC')自然不会产生任何变化。

另外你期望输出带Z的ISO格式，但原代码用toDateTimeString()返回的是Y-m-d H:i:s格式，这也和预期输出格式不符。

修复方案 #

根据你的需求（把阿姆斯特丹时区的12:00转换为UTC时间10:00），分两种场景处理：

场景1：前端传入的时间带错误的Z后缀

如果前端本应传入阿姆斯特丹时区的时间，但错误地加上了Z，需要先移除时区标识，再用目标时区解析：

convertToUTC(
    $request->scheduled_at, // 2023-05-13T12:00:00.000Z
    $request->user()->company->timezone // Europe/Amsterdam
); 

function convertToUTC($timestamp, $timezone)
{
    // 移除字符串中的UTC标识Z，确保Carbon使用指定时区解析
    $localTimeStr = str_replace('Z', '', $timestamp);
    $carbon = \Carbon\Carbon::parse($localTimeStr, $timezone);
    
    // 转换为UTC并输出带Z的ISO格式
    return $carbon->setTimezone('UTC')->toIso8601String();
}

场景2：前端应传入不带时区的阿姆斯特丹本地时间

如果前端修正输入，传入不带Z的阿姆斯特丹时间（比如2023-05-13T12:00:00.000），只需调整输出格式即可：

convertToUTC(
    $request->scheduled_at, // 2023-05-13T12:00:00.000
    $request->user()->company->timezone // Europe/Amsterdam
); 

function convertToUTC($timestamp, $timezone)
{
    $carbon = new \Carbon\Carbon($timestamp, $timezone);
    $carbon->setTimezone('UTC');
    
    // 用toIso8601String()输出带Z的标准ISO格式
    return $carbon->toIso8601String();
}

补充说明 #

• Carbon解析规则：当时间字符串包含明确时区信息（如Z、+02:00），第二个参数的时区会被忽略；只有当字符串不带时区时，才会使用传入的时区参数解析。
• toIso8601String()会返回带Z的UTC时间格式，完全匹配你的预期输出。

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