本文介绍如何使用 carbon 和 carbonperiod 高效计算多个日期范围（可能重叠）所覆盖的唯一自然日总数，通过合并数组并去重实现，避免手动处理区间交集逻辑。
本文介绍如何使用 carbon 和 carbonperiod 高效计算多个日期范围（可能重叠）所覆盖的唯一自然日总数，通过合并数组并去重实现，避免手动处理区间交集逻辑。
在实际业务中（如假期统计、资源占用分析、订阅有效期叠加等），我们常需统计多个日期范围共同覆盖的不重复自然日总数。例如：2022-12-01–10（10天）、2022-12-06–15（10天）和 2022-12-21–25（5天）三个区间存在重叠（12月6–10日被重复覆盖），真实唯一天数为 10 + 5 + 5 = 20 天（而非简单求和的25天）。
CarbonPeriod 提供了直观的日期序列生成能力，而 PHP 原生数组函数可高效完成去重与计数。核心思路是：将每个 CarbonPeriod 转为日期对象数组 → 合并所有数组 → 去除重复日期 → 统计剩余元素个数。
以下为完整可运行示例：
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 对象的 __toString() 或 timestamp 自动判重）
$allDates = array_merge(
$dateRange_1->toArray(),
$dateRange_2->toArray(),
$dateRange_3->toArray()
);
$uniqueDays = array_unique($allDates, SORT_REGULAR); // 必须用 SORT_REGULAR 确保 Carbon 对象正确比较
$totalUniqueDays = count($uniqueDays);
echo "总唯一天数：{$totalUniqueDays}"; // 输出：20✅ 关键说明：
立即学习“PHP免费学习笔记（深入）”；
-
CarbonPeriod::toArray()返回Carbon实例数组（非字符串），因此必须使用SORT_REGULAR模式调用array_unique()，否则默认字符串比较会失败； - 此方法天然支持任意数量的日期范围（只需扩展
array_merge参数）； - 时间复杂度为 O(n)，n 为所有范围总天数，对数千天内场景性能优异；
- 若需兼容 PHP array_flip(array_map('strtotime', ...))）进一步优化。
⚠️ 注意事项：
- 所有日期字符串需符合 ISO 8601 格式（如
'Y-m-d'），否则CarbonPeriod::create()可能解析异常； -
CarbonPeriod默认包含起止日期（闭区间），符合日常“包含首尾”的业务语义； - 不适用于需要保留时分秒精度的场景——若需精确到秒，请改用
Carbon::parse()->getTimestamp()进行毫秒级去重。
该方案简洁、可靠、无第三方依赖，是 Carbon 生态中处理多区间并集天数问题的推荐实践。
