PHP中高效计算日期范围交集：以考勤统计为例

// 定义周范围
$weekStart = new DateTime("2021-12-20");
$weekEnd = new DateTime("2021-12-24");

// 定义缺勤范围
$absenceStart = new DateTime("2021-12-22");
$absenceEnd = new DateTime("2021-12-23");

// 定义日期间隔
$interval = DateInterval::createFromDateString('1 day');

// 为了确保DatePeriod包含结束日期，需要将结束日期加一天
$weekEndInclusive = (clone $weekEnd)->add($interval);
$absenceEndInclusive = (clone $absenceEnd)->add($interval);

// 生成日期周期
$weekPeriod = new DatePeriod($weekStart, $interval, $weekEndInclusive);
$absencePeriod = new DatePeriod($absenceStart, $interval, $absenceEndInclusive);

$weekArray = [];
$absenceArray = [];

// 将周范围内的日期格式化为一年中的第几天（'z'）并存入数组
foreach ($weekPeriod as $dt) {
    $weekArray[] = $dt->format('z');
}

// 将缺勤范围内的日期格式化为一年中的第几天（'z'）并存入数组
foreach ($absencePeriod as $dt) {
    $absenceArray[] = $dt->format('z');
}

// 计算两个数组的交集
$intersectionResult = array_intersect($weekArray, $absenceArray);

// 统计交集天数
$absenceDays = count($intersectionResult);

echo "员工在本周 ({$weekStart->format('Y-m-d')} - {$weekEnd->format('Y-m-d')}) 共有 <b>{$absenceDays}</b> 天缺勤。";
// 输出: 员工在本周 (2021-12-20 - 2021-12-24) 共有 2 天缺勤。

/**
 * 计算两个日期范围的交集天数
 *
 * @param DateTime $range1Start 第一个日期范围的开始日期
 * @param DateTime $range1End 第一个日期范围的结束日期
 * @param DateTime $range2Start 第二个日期范围的开始日期
 * @param DateTime $range2End 第二个日期范围的结束日期
 * @return int 交集天数
 */
function calculateDateRangeIntersectionDays(
    DateTime $range1Start, DateTime $range1End,
    DateTime $range2Start, DateTime $range2End
): int {
    // 确定交集的开始日期：取两个开始日期中较晚的一个
    // max() 函数在比较 DateTime 对象时会基于时间戳进行比较
    $intersectionStart = max($range1Start, $range2Start);

    // 确定交集的结束日期：取两个结束日期中较早的一个
    $intersectionEnd = min($range1End, $range2End);

    // 检查是否存在有效的交集
    // 如果交集开始日期在交集结束日期之后，则没有重叠
    if ($intersectionStart > $intersectionEnd) {
        return 0;
    }

    // 计算交集天数
    // DateTime::diff() 返回一个 DateInterval 对象
    // DateInterval->days 属性表示两个日期之间的天数差
    // 由于是包含两端日期，例如 2021-12-22 到 2021-12-23，diff()->days 为 1，实际有 2 天，所以需要加1
    $diff = $intersectionStart->diff($intersectionEnd);
    return $diff->days + 1;
}

// 示例数据
// 假设日期字符串表示的是当天 00:00:00
$weekStart = new DateTime("2021-12-20");
$weekEnd = new DateTime("2021-12-24"); // 包含2021-12-24

$absenceStart = new DateTime("2021-12-22");
$absenceEnd = new DateTime("2021-12-23"); // 包含2021-12-23

// 调用函数计算缺勤天数
$absenceDaysOptimized = calculateDateRangeIntersectionDays(
    $weekStart, $weekEnd,
    $absenceStart, $absenceEnd
);

echo "（优化后）员工在本周 ({$weekStart->format('Y-m-d')} - {$weekEnd->format('Y-m-d')}) 共有 <b>{$absenceDaysOptimized}</b> 天缺勤。";
// 输出: （优化后）员工在本周 (2021-12-20 - 2021-12-24) 共有 2 天缺勤。