如何利用MySQL日期函数计算两个时间点之间的工作日差值？-mysql教程-PHP中文网

mysql无内置workday函数，需用weekday()结合整除取模计算完整周的周末天数，再手动剔除节假日；注意首尾日期是否包含及跨周时的余数处理。

如何利用mysql日期函数计算两个时间点之间的工作日差值？

MySQL 中没有内置的 `WORKDAY` 函数，必须手动排除周末和节假日

MySQL 原生不支持像 Excel 那样的 NETWORKDAYS 或 WORKDAY，也没有自动识别节假日的能力。所有工作日计算都得靠日期运算 + 条件过滤实现，核心思路是：先算总天数，再减去周末天数，最后手动剔除节假日（如果需要）。

常见错误是直接用 TIMESTAMPDIFF(DAY, start_date, end_date) 当工作日差——这返回的是自然日差，包含周六、周日，甚至节假日。

WEEKDAY() 返回 0（周一）到 6（周日），比 DAYOFWEEK()（1=周日，7=周六）更适合做工作日逻辑
注意：start_date 和 end_date 是否包含当天？业务上通常「含头不含尾」或「含头含尾」，需统一约定，否则差 1 天
跨多周时，不能只看首尾两天的 weekday，必须按整周 + 余数分别处理

用 `WEEKDAY()` + 整除和取模快速算出中间完整周的周六/日数量

假设 start_date ，且要计算「从 start_date 到 end_date（含）」之间的工作日数，可拆解为：

SET @start = '2024-09-02';  -- 周一
SET @end   = '2024-09-13';  -- 周五（共 12 天，含 2 个周末）
<p>SELECT 
DATEDIFF(@end, @start) + 1 </p>

FLOOR((DATEDIFF(@end, @start) + 1 + WEEKDAY(@start)) / 7) * 2

IF(WEEKDAY(@start) + DATEDIFF(@end, @start) + 1 >= 7, LEAST(2, (WEEKDAY(@start) + DATEDIFF(@end, @start) + 1) % 7), 0)

IF(WEEKDAY(@start) = 6, 1, 0) -- 如果起始日是周六，多扣 1 天
IF(WEEKDAY(@start) = 5 AND DATEDIFF(@end, @start) >= 1, 1, 0); -- 起始日是周五且跨天，周六也算在内
实际开发中更推荐分步写法，避免一行公式出错难调试：
- 先算总天数：DATEDIFF(end, start) + 1
- 算完整周数：FLOOR(DATEDIFF(end, start) / 7)，每完整周固定减 2 天
- 算剩余天数（0~6 天）中落在周六/日的数量：用 WEEKDAY(start) 推出剩余区间覆盖哪些 weekday
- 特别检查边界：若 start 是周六（WEEKDAY() = 5）或周日（=6），需额外扣除

节假日需单独建表并 LEFT JOIN 过滤，不能硬编码在 SQL 里

把节假日写死在 WHERE 条件里（如 NOT IN ('2024-01-28', '2024-02-10')）会导致维护困难、无法复用、SQL 过长易错。正确做法是建一张 holidays 表：

MySQL（Linux）

MySQL 9.6.0是面向Linux平台的2026年创新版本，核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层，确保所有数据变更均被完整记录至Binlog，彻底解决了CDC（变更数据捕获）与主从复制中的数据不一致难题。此外，该版本引入container_aware启动选项以原生适配容器环境，并对审计日志进行了组件化重构，为追求极致数据一致性与云原生体验的开发者提供了全新选择。

下载

CREATE TABLE holidays (
  holiday_date DATE PRIMARY KEY,
  name VARCHAR(50)
);

然后在工作日计算中 JOIN 排除：

先生成日期序列（可用递归 CTE 或辅助数字表），再 LEFT JOIN holidays，WHERE h.holiday_date IS NULL
若只查少量日期范围，也可用子查询：AND DATE(col) NOT IN (SELECT holiday_date FROM holidays)，但性能随数据量下降明显
注意时区：确保 holidays.holiday_date 和业务时间字段使用相同时区（推荐全用 UTC 存储）

用 MySQL 8.0+ 的递归 CTE 生成日期序列最直观，但要注意性能阈值

对于不超过 3 个月的范围，递归 CTE 是最易读、最贴近业务语义的方式：

WITH RECURSIVE date_range AS (
  SELECT @start AS dt
  UNION ALL
  SELECT DATE_ADD(dt, INTERVAL 1 DAY)
  FROM date_range
  WHERE dt <p>但要注意：</p>

默认递归深度限制是 1000，超限会报错 Recursive query aborted after 1001 iterations，需提前设 SET SESSION cte_max_recursion_depth = 5000;
超过 90 天的范围建议改用预生成的 numbers 辅助表，避免每次执行都递归
该方式本质是逐行判断，大数据量场景下比数学推导慢一个数量级，线上高频调用应避免

真正麻烦的不是算周末，而是节假日规则——调休上班日（如节前周六上班）没法靠固定表解决，最终得靠业务系统标记或人工维护 is_workday BOOLEAN 字段。