如何使用 Carbon 在 Laravel 中准确计算跨午夜的时间差

use Carbon\Carbon;

$startTime = "06:00:00";
$endTime = "00:00:00";

$carbon_startDate = Carbon::parse($startTime); // 默认为当前日期 06:00:00
$carbon_endDate = Carbon::parse($endTime);   // 默认为当前日期 00:00:00

$totalDuration = $carbon_startDate->diffInHours($carbon_endDate);
// 结果为 6，而不是期望的 18

<?php

namespace App\Helpers; // 根据你的项目结构调整命名空间

use Carbon\Carbon;

class TimeCalculator
{
    /**
     * 计算两个时间点之间的小时差，支持跨午夜。
     *
     * @param array $working_time 包含 'start_time' 和 'end_time' 键的数组，时间格式如 "HH:MM" 或 "HH:MM:SS"。
     * @return int 返回小时差的整数值。
     */
    public static function calculateDurationInHours(array $working_time): int
    {
        // 确保输入时间字符串有效，并提取纯时间部分进行比较
        // Carbon::parse() 可以处理 "HH:MM" 和 "HH:MM:SS" 格式
        $rawStartTime = $working_time['start_time'];
        $rawEndTime = $working_time['end_time'];

        // 用于判断是否跨午夜的纯时间字符串
        $startTimeOnly = Carbon::parse($rawStartTime)->format('H:i:s');
        $endTimeOnly = Carbon::parse($rawEndTime)->format('H:i:s');

        $totalDuration = 0;

        // 判断是否为跨午夜的时间段（例如 22:00 -> 06:00）
        // 注意：这里的比较是基于字符串，表示时间点在一天中的顺序
        if ($startTimeOnly > $endTimeOnly) {
            // 情况1：时间段跨越午夜
            // 例如：start_time = "22:00", end_time = "06:00"
            // 或者：start_time = "06:00", end_time = "00:00" (用户期望是第二天00:00)

            $currentDate = Carbon::now()->format('Y-m-d');

            // 构造起始时间的完整日期时间（当前日期 + 起始时间）
            // 例如：2023-10-27 22:00:00
            $fullStartTime = Carbon::parse($currentDate . ' ' . $rawStartTime);

            // 构造结束时间的完整日期时间（下一天 + 结束时间）
            // 例如：2023-10-28 06:00:00
            $nextDate = Carbon::now()->addDay()->format('Y-m-d');
            $fullEndTime = Carbon::parse($nextDate . ' ' . $rawEndTime);

            // 计算小时差
            $totalDuration = $fullStartTime->diffInHours($fullEndTime);

        } else {
            // 情况2：时间段在同一天内
            // 例如：09:00 -> 17:00
            // 或者：00:00 -> 06:00 (用户期望是当天06:00)

            // 直接使用原始时间字符串解析，Carbon 会默认使用当前日期
            // 例如：2023-10-27 09:00:00 和 2023-10-27 17:00:00
            $fullStartTime = Carbon::parse($rawStartTime);
            $fullEndTime = Carbon::parse($rawEndTime);

            $totalDuration = $fullStartTime->diffInHours($fullEndTime);
        }

        return $totalDuration;
    }
}

// 示例用法：
// 模拟用户输入
$working_time_cross_midnight_example1 = ['start_time' => '06:00', 'end_time' => '00:00'];
$working_time_cross_midnight_example2 = ['start_time' => '22:00', 'end_time' => '06:00'];
$working_time_same_day_example1 = ['start_time' => '09:00', 'end_time' => '17:00'];
$working_time_same_day_example2 = ['start_time' => '00:00', 'end_time' => '06:00'];

echo "6 AM to 12 AM (cross midnight): " . TimeCalculator::calculateDurationInHours($working_time_cross_midnight_example1) . " hours\n"; // 预期输出 18
echo "10 PM to 6 AM (cross midnight): " . TimeCalculator::calculateDurationInHours($working_time_cross_midnight_example2) . " hours\n"; // 预期输出 8
echo "9 AM to 5 PM (same day): " . TimeCalculator::calculateDurationInHours($working_time_same_day_example1) . " hours\n"; // 预期输出 8
echo "12 AM to 6 AM (same day): " . TimeCalculator::calculateDurationInHours($working_time_same_day_example2) . " hours\n"; // 预期输出 6