本文介绍如何使用 carbon 和 carbonperiod 高效计算多个日期范围合并后的唯一总天数，自动去重重叠部分，适用于排班、资源占用统计等场景。
本文介绍如何使用 carbon 和 carbonperiod 高效计算多个日期范围合并后的唯一总天数，自动去重重叠部分，适用于排班、资源占用统计等场景。
在实际开发中，我们常需统计多个日期范围（如请假时段、设备租用期、活动档期）覆盖的实际不重复天数。当这些范围存在重叠时，简单求和会导致重复计数。Carbon 本身未提供直接合并多段 CarbonPeriod 并去重的内置方法，但借助其 toArray() 返回的 Carbon 实例数组，结合 PHP 原生数组函数，可简洁、可靠地实现该需求。
核心思路是：将每个 CarbonPeriod 转为日期对象数组 → 合并所有数组 → 利用 array_unique() 去重（Carbon 对象在默认比较下可被正确识别为重复）→ 统计最终数组长度。
以下为完整示例代码：
use Carbon\CarbonPeriod;
$startDate_1 = '2022-12-01';
$endDate_1 = '2022-12-10';
$startDate_2 = '2022-12-06';
$endDate_2 = '2022-12-15';
$startDate_3 = '2022-12-21';
$endDate_3 = '2022-12-25';
$dateRange_1 = CarbonPeriod::create($startDate_1, $endDate_1);
$dateRange_2 = CarbonPeriod::create($startDate_2, $endDate_2);
$dateRange_3 = CarbonPeriod::create($startDate_3, $endDate_3);
// 合并所有日期并去重（Carbon 对象基于日期值自动判重）
$allDays = array_merge(
$dateRange_1->toArray(),
$dateRange_2->toArray(),
$dateRange_3->toArray()
);
$uniqueDays = array_unique($allDays);
$totalUniqueDays = count($uniqueDays);
echo "唯一总天数：{$totalUniqueDays}"; // 输出：20✅ 注意事项与优化建议：
立即学习“PHP免费学习笔记（深入）”；
- 性能提示：该方法对中小型日期范围（如单个范围 ≤ 数百天，总数 ≤ 数千天）高效可靠；若处理超大范围（如跨数年、数千段），建议改用区间合并算法（先排序端点，再线性合并），避免内存膨胀。
-
时区一致性：确保所有日期字符串或
Carbon实例使用相同时区（推荐显式指定，如Carbon::createFromFormat('Y-m-d', $date, 'UTC')），防止因时区差异导致意外重复或遗漏。 -
边界包含性：
CarbonPeriod::create($start, $end)默认包含首尾日期（inclusive模式），符合常规业务逻辑；如需排除结束日，请使用CarbonPeriod::create($start, 'P' . $days . 'D')或手动调整$end = $endDate->subDay()。 - 扩展性：可轻松封装为复用函数：
function countUniqueDaysInPeriods(...$periods): int
{
$allDates = [];
foreach ($periods as $period) {
if ($period instanceof CarbonPeriod) {
$allDates = array_merge($allDates, $period->toArray());
}
}
return count(array_unique($allDates));
}
// 调用
$total = countUniqueDaysInPeriods($dateRange_1, $dateRange_2, $dateRange_3);该方案简洁、可读性强，充分利用了 Carbon 的易用性与 PHP 数组原生能力，在绝大多数业务场景中是首选实践。
