计算两个日期间工作日数（支持自定义周工作天数）

本文介绍了一种精准、灵活且生产就绪的 PHP 解决方案，用于计算任意两个日期间的工作日天数——不仅支持传统 5 天工作制，更可自定义任意工作日组合（如单休的 6 天制、弹性轮班的 [1,3,5,6] 等），通过 DateTime 类严谨处理跨周边界（如起始日为周日、结束日为周六等易出错情形），彻底规避时间戳差值+模运算导致的计数偏差，让排班系统、工时统计、服务有效期等业务场景的时间计算既可靠又可配置。

本文提供一种准确、可扩展的 PHP 方法，用于计算指定起止日期间的工作日天数，支持将任意天数（如 6 天/周）设为工作日，并自动排除周末（默认为周日），避免传统算法因边界日期处理不当导致的计数偏差。

本文提供一种准确、可扩展的 PHP 方法，用于计算指定起止日期间的工作日天数，支持将任意天数（如 6 天/周）设为工作日，并自动排除周末（默认为周日），避免传统算法因边界日期处理不当导致的计数偏差。

在实际业务开发中（如排班系统、工时统计、服务有效期计算），仅依赖 5 天/周 的硬编码逻辑已无法满足多样化需求——例如某些地区实行单休（6 天工作制）、轮班制或特殊行业工作日安排。原问题中使用时间戳差值与手动模运算的方式，因未严谨处理跨周首尾日期的包含逻辑（尤其是当起始日为周日、结束日为周六等边界情形），导致 2022 年 4 月（2022-04-01 至 2022-04-30）本应返回 26 个工作日（共 30 天，含 4 个周日），却错误输出 25。

以下是一个健壮、面向对象且语义清晰的解决方案，基于 DateTime 类实现，核心思路是：按“完整周数 × 每周工作日数” + “剩余不完整周中的实际工作日”进行分步统计，并支持两种调用方式：

• 传入整数（如 6）：表示从周一（1）开始连续的 n 天为工作日（即 [1,2,3,4,5,6]）；
• 传入数组（如 [1,3,5,6]）：显式指定任意工作日（周一=1，周日=7），灵活适配弹性工作制。

/**
 * 计算两个日期之间的工作日总数（支持自定义工作日集合）
 * @param string $start_date 起始日期，格式 'Y-m-d'
 * @param string $end_date 结束日期，格式 'Y-m-d'
 * @param array|int $working_days 工作日定义：数组（如 [1,2,3,4,5,6]）或整数（如 6 表示周一至周六）
 * @return int 工作日总天数
 */
function get_working_days(string $start_date, string $end_date, array|int $working_days = [1, 2, 3, 4, 5]): int
{
    $start = DateTime::createFromFormat('Y-m-d', $start_date);
    $end = DateTime::createFromFormat('Y-m-d', $end_date);

    if (!$start || !$end || $start > $end) {
        return 0;
    }

    // 将 'w' (0=Sunday) 转为 1=Monday ~ 7=Sunday
    $start_day = (int)$start->format('w') + 1;
    $end_day = (int)$end->format('w') + 1;

    // 标准化 working_days 为数组
    if (is_int($working_days)) {
        $working_days = range(1, min($working_days, 7));
    }

    // 总秒数差 → 计算完整周数（向下取整）
    $total_seconds = $end->getTimestamp() - $start->getTimestamp();
    $full_weeks = (int)floor($total_seconds / (60 * 60 * 24 * 7));

    $working_days_count = 0;

    // 对每个指定工作日，判断其在首尾不完整周中是否出现
    foreach ($working_days as $day_num) {
        $in_partial_week = false;

        if ($start_day <= $end_day) {
            // 同一周或正向跨周：区间为 [start_day, end_day]
            $in_partial_week = ($day_num >= $start_day && $day_num <= $end_day);
        } else {
            // 反向跨周（如 周六→下周二）：区间为 [start_day, 7] ∪ [1, end_day]
            $in_partial_week = ($day_num >= $start_day || $day_num <= $end_day);
        }

        // 该工作日在完整周中出现 full_weeks 次，在首尾部分周中最多出现 1 次
        $working_days_count += $full_weeks + ($in_partial_week ? 1 : 0);
    }

    return $working_days_count;
}

// ✅ 示例：2022年4月（30天），工作日为周一至周六（6天/周）→ 应得 26
echo get_working_days('2022-04-01', '2022-04-30', 6); // 输出：26

// ✅ 示例：仅周一、三、五工作 → 自定义数组
echo get_working_days('2022-04-01', '2022-04-30', [1, 3, 5]); // 输出：13

// ✅ 示例：包含节假日扣除（可扩展）
$holidays = ['2022-04-15', '2022-04-22']; // 假设为法定假日
$base_days = get_working_days('2022-04-01', '2022-04-30', 6);
foreach ($holidays as $holiday) {
    if (in_array((int)(new DateTime($holiday))->format('w') + 1, [1,2,3,4,5,6])) {
        $base_days--;
    }
}
echo $base_days; // 扣除后结果

关键优势与注意事项：

• ✅ 边界安全：通过 DateTime::format('w') + 1 统一使用 ISO 周标准（周一=1），避免 date("N") 与 date("w") 混用引发的逻辑混乱；
• ✅ 跨周鲁棒：使用 start_day <= end_day 判断区间是否跨越周末，正确覆盖“周六→下周二”等场景；
• ✅ 零依赖：不依赖外部库，仅需 PHP 5.5+；
• ⚠️ 节假日需手动处理：本函数聚焦于规则工作日计算；如需排除法定假日，建议在返回结果后二次过滤（如上示例），或封装为带 $holidays 参数的增强版；
• ⚠️ 日期有效性校验：已内置 !$start || !$end || $start > $end 防御，生产环境建议补充 DateTime::getLastErrors() 错误检查。

该方案将复杂的时间逻辑解耦为数学可验证的“周基数 + 偏移量”，兼顾准确性、可读性与扩展性，是处理多场景工作日计算的推荐实践。

到这里，我们也就讲完了《计算两个日期间工作日数（支持自定义周工作天数）》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！