Laravel使用Carbon/CarbonInterval计算跨天班次员工工时结果异常

问题场景 #

• 系统排班存在跨日期夜班场景：例如7月1日21:00开始的夜班，结束时间为7月2日03:00，预期计算得到的该班次员工总工时为6小时。
• 现有代码可正常统计同日期内的班次工时，例如7月1日15:00-21:00的班次可正确返回6小时结果，但遇到跨日期班次时计算结果不符合预期：上述跨天夜班场景实际返回18小时。

原有问题代码 #

$attendance_start_time = \Carbon\Carbon::parse($shift->start_time);
$attendance_end_time = \Carbon\Carbon::parse($shift->end_time);

$total_attendance_time=$attendance_end_time->diffInSeconds($attendance_start_time,true);
\Carbon\CarbonInterval::seconds($total_attendance_time)->cascade()->forHumans()

异常原因 #

直接通过Carbon解析班次起止时间时，若未携带完整日期信息、或存储的起止时间仅为时分值，跨天班次的结束时间会被解析为开始时间当日的早于开始时间的时点，此时计算两个时点的差值会得到反向的时间间隔，最终返回18小时的错误结果。

修复方案 #

增加跨天判断逻辑：如果解析后的结束时间早于开始时间，判定为跨零点班次，将结束时间自动顺延1天再计算时间差即可。
修复后代码如下：

$attendance_start_time = \Carbon\Carbon::parse($shift->start_time);
$attendance_end_time = \Carbon\Carbon::parse($shift->end_time);

// 处理跨零点班次：结束时间早于开始时间时，自动将结束时间顺延至次日
if ($attendance_end_time->lt($attendance_start_time)) {
    $attendance_end_time->addDay();
}

$total_attendance_time = $attendance_end_time->diffInSeconds($attendance_start_time, true);
$work_duration = \Carbon\CarbonInterval::seconds($total_attendance_time)->cascade()->forHumans();

逻辑验证 #

• 同日班次：7月1日15:00-21:00，结束时间晚于开始时间，不触发顺延逻辑，计算得到工时6小时，结果正确。
• 跨天夜班：7月1日21:00-次日03:00，结束时间早于开始时间触发顺延，计算得到工时6小时，符合预期。

注：该逻辑默认单班次时长不超过24小时，适配绝大多数常规企业排班场景，若存在连续多日的超长班次，可根据实际业务规则调整顺延天数逻辑。

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