本文提供一种准确、可扩展的 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
- ✅ 零依赖：不依赖外部库，仅需 PHP 5.5+；
- ⚠️ 节假日需手动处理：本函数聚焦于规则工作日计算；如需排除法定假日，建议在返回结果后二次过滤（如上示例），或封装为带 $holidays 参数的增强版；
- ⚠️ 日期有效性校验：已内置 !$start || !$end || $start > $end 防御，生产环境建议补充 DateTime::getLastErrors() 错误检查。
该方案将复杂的时间逻辑解耦为数学可验证的“周基数 + 偏移量”，兼顾准确性、可读性与扩展性，是处理多场景工作日计算的推荐实践。
立即学习“PHP免费学习笔记（深入）”；
