使用 Carbon 在 Laravel 中计算用户会话时长

use Carbon\Carbon;
use Carbon\CarbonInterface;

// 假设我们从软件中获取到的原始时间字符串
$clockInRaw = "clock in time = 5:00 PM";
$clockOutRaw = "clock out time = 6:10 PM";

// 通过字符串分割来提取纯净的时间字符串
// 实际应用中，建议尽量直接获取"5:00 PM"这样的纯净格式，以减少解析复杂度。
$inParts = explode(' ', $clockInRaw);
$outParts = explode(' ', $clockOutRaw);

// 确保索引存在，并拼接时间与AM/PM标记
// 例如，从 $inParts[4] 获取 "5:00"，$inParts[5] 获取 "PM"
$startTimeString = $inParts[4] . ' ' . $inParts[5]; // 结果："5:00 PM"
$endTimeString = $outParts[4] . ' ' . $outParts[5]; // 结果："6:10 PM"

// 使用 Carbon::parse() 将时间字符串转换为 Carbon 实例
// 注意：如果未提供日期，Carbon 会默认使用当前日期。
// 对于跨天的会话，例如从晚上签入到第二天早上签出，需要提供完整的日期和时间。
$startTime = Carbon::parse($startTimeString); // 例如：当前日期 5:00 PM
$endTime = Carbon::parse($endTimeString);   // 例如：当前日期 6:10 PM

// 计算时间差并以人类可读的格式输出
$timeSpent = $endTime->diffForHumans($startTime, [
    'parts' => 2, // 显示最多两个时间单位（例如：1小时, 10分钟）。如果设置为1，则只显示"1小时"。
    'join' => ', ', // 各单位之间用逗号和空格连接。
    'syntax' => CarbonInterface::DIFF_ABSOLUTE, // 输出绝对差值，不带"before"/"after"等修饰词。
]);

echo "用户在软件中停留时间: " . $timeSpent; // 示例输出: 用户在软件中停留时间: 1小时, 10分钟

<?php

use Carbon\Carbon;
use Carbon\CarbonInterface;

// --- 模拟从外部系统获取的原始数据 ---
$clockInRaw = "clock in time = 5:00 PM";
$clockOutRaw = "clock out time = 6:10 PM";

// --- 步骤1: 解析原始时间字符串，提取纯净时间 ---
$inParts = explode(' ', $clockInRaw);
$outParts = explode(' ', $clockOutRaw);

$startTimeString = $inParts[4] . ' ' . $inParts[5]; // "5:00 PM"
$endTimeString = $outParts[4] . ' ' . $outParts[5]; // "6:10 PM"

// --- 步骤2: 创建 Carbon 实例 ---
// 注意：如果会话可能跨天，请务必在时间字符串前加上日期，
// 例如：'2023-10-26 5:00 PM'
$startTime = Carbon::parse($startTimeString);
$endTime = Carbon::parse($endTimeString);

// --- 步骤3: 计算时间差并以人类可读的格式输出 ---
$timeSpent = $endTime->diffForHumans($startTime, [
    'parts' => 2, // 显示最多两个时间单位 (例如：1小时, 10分钟)
    'join' => ', ', // 各单位之间用逗号和空格连接
    'syntax' => CarbonInterface::DIFF_ABSOLUTE, // 输出绝对差值，不带"before"/"after"
]);

echo "用户在软件中停留时间: " . $timeSpent . PHP_EOL;

// 示例2: 跨天情况 (假设日期为2023年10月26日和27日)
$clockInRaw_crossDay = "clock in time = 2023-10-26 10:00 PM";
$clockOutRaw_crossDay = "clock out time = 2023-10-27 02:30 AM";

// 这里直接假设获取到的已经是带日期的完整时间字符串
$startTimeCrossDay = Carbon::parse(str_replace('clock in time = ', '', $clockInRaw_crossDay));
$endTimeCrossDay = Carbon::parse(str_replace('clock out time = ', '', $clockOutRaw_crossDay));

$timeSpentCrossDay = $endTimeCrossDay->diffForHumans($startTimeCrossDay, [
    'parts' => 3, // 增加到3个部分，以防出现天数
    'join' => ', ',
    'syntax' => CarbonInterface::DIFF_ABSOLUTE,
]);

echo "用户跨天在软件中停留时间: " . $timeSpentCrossDay . PHP_EOL; // 示例输出: 4小时, 30分钟