Laravel Carbon 时间转换：将任意时区时间精确转换为 UTC

<?php

namespace App\Http\Controllers;

use Carbon\Carbon;
use Illuminate\Http\Request;

class TimeConversionController extends Controller
{
    public function convertUserTime(Request $request)
    {
        // 假设 $request->open_at 是用户输入的字符串，例如 '08:45 P.M.'
        // 或者 '2023-10-26 08:45 PM'

        $userProvidedTime = $request->open_at ?? '08:45 P.M.'; // 模拟用户输入

        // --- 场景一：用户输入不含时区信息，但我们知道其原始时区 ---
        // 这是最常见的情况，用户在界面上输入一个时间，但没有指明时区。
        // 你需要从其他地方（如用户设置、浏览器时区检测等）获取用户所在的时区。
        $userTimezone = 'America/New_York'; // 示例：假设用户在纽约时区

        // 步骤1: 解析用户输入，并明确告知 Carbon 这个时间属于哪个时区
        // Carbon::parse() 的第二个参数用于指定解析时的时区
        $carbonInstanceInUserTimezone = Carbon::parse($userProvidedTime, $userTimezone);

        // 此时 $carbonInstanceInUserTimezone 内部表示的是 'America/New_York' 时区的 20:45 (PM)
        // 例如，如果当前日期是 2023-10-26，则表示 2023-10-26 20:45:00-04:00 (纽约时间)

        // 步骤2: 将这个时间点转换为 UTC 时区
        $utcTimeFromUserTimezone = $carbonInstanceInUserTimezone->setTimezone('UTC');

        // 输出示例：2023-10-27 00:45:00 (UTC)
        // dd('从用户时区转换到 UTC:', $utcTimeFromUserTimezone->toDateTimeString());


        // --- 场景二：用户输入已包含时区信息（例如 ISO 8601 格式） ---
        // 如果用户输入的时间字符串本身就包含了时区偏移，Carbon::parse() 会自动识别。
        $timeWithOffset = '2023-10-26 20:45:00-04:00'; // 示例：纽约时间带偏移量
        $carbonInstanceWithOffset = Carbon::parse($timeWithOffset); // Carbon 会自动识别时区

        // 直接将其转换为 UTC
        $utcTimeFromOffset = $carbonInstanceWithOffset->setTimezone('UTC');

        // 输出示例：2023-10-27 00:45:00 (UTC)
        // dd('从带偏移量字符串转换到 UTC:', $utcTimeFromOffset->toDateTimeString());


        // --- 场景三：默认认为用户输入是基于应用程序的默认时区 ---
        // 如果你的应用场景是所有用户都在同一个时区，或者你默认将所有用户输入
        // 都视为应用程序的默认时区，那么 Carbon::parse() 的默认行为就足够了。
        $appTimezone = config('app.timezone'); // 获取 Laravel 应用默认时区，例如 'Asia/Shanghai'
        $inputTimeAssumedInAppTimezone = $request->open_at ?? '08:45 P.M.';

        // Carbon::parse() 会将 $inputTimeAssumedInAppTimezone 解析为 $appTimezone 时区的时间
        $carbonInstanceInAppTimezone = Carbon::parse($inputTimeAssumedInAppTimezone);

        // 此时 $carbonInstanceInAppTimezone 内部表示的是 'Asia/Shanghai' 时区的 20:45 (PM)
        // 例如，如果当前日期是 2023-10-26，则表示 2023-10-26 20:45:00+08:00 (上海时间)

        // 将其转换为 UTC
        $utcTimeFromAppTimezone = $carbonInstanceInAppTimezone->setTimezone('UTC');

        // 输出示例：2023-10-26 12:45:00 (UTC)
        // dd('从应用默认时区转换到 UTC:', $utcTimeFromAppTimezone->toDateTimeString());


        // --- 应用于数据库查询 ---
        // 一旦获得了正确的 UTC 时间 Carbon 实例，就可以将其用于数据库操作。
        // Laravel Eloquent 通常可以直接接受 Carbon 实例。
        // $query->where('open_at', '>=', $utcTimeFromUserTimezone);

        // 如果你的数据库字段只存储时间部分，并且需要进行时间比较
        // 注意：这种比较通常不够精确，推荐存储完整的 datetime 并进行 datetime 比较。
        // $query->whereTime('open_at', '>=', $utcTimeFromUserTimezone->toTimeString());

        return response()->json([
            'user_input' => $userProvidedTime,
            'utc_from_user_timezone' => $utcTimeFromUserTimezone->toDateTimeString(),
            'utc_from_offset_string' => $utcTimeFromOffset->toDateTimeString(),
            'utc_from_app_timezone_assumption' => $utcTimeFromAppTimezone->toDateTimeString(),
        ]);
    }
}