
本文提供一种准确、可扩展的 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 = $start_day && $day_num = $start_day || $day_num 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免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











