应建 calendar 表而非硬编码判断：含 date、is_workday、holiday_name 字段，每年初更新以准确标记调休日；JOIN 该表做考勤分组统计，避免函数包裹字段导致索引失效，并妥善处理 NULL 和跨年打卡。
怎么判断某天是工作日还是节假日
直接用数据库内置日期函数硬算星期几，再手动排除法定节假日，既难维护又容易出错。更可靠的做法是提前建一张 calendar 表，字段至少包含 date（DATE 类型）、is_workday（TINYINT 或 BOOLEAN）、holiday_name（VARCHAR，可为空）。每年初更新一次，连调休日也能准确标记。
常见错误是把节假日逻辑写进 SQL WHERE 或 CASE 里——比如 CASE WHEN DAYOFWEEK(date) IN (1,7) THEN '休息'...，这漏掉了调休上班日，也扛不住国务院每年发的放假通知变动。
- MySQL 中避免用
DAYOFWEEK()判周日（返回值是 1=周日），建议统一用WEEKDAY()（0=周一）更符合业务直觉 - PostgreSQL 用
EXTRACT(DOW FROM date)，注意 0=周日，需% 7调整或改用EXTRACT(ISODOW FROM date)（1=周一） - 别在查询里硬编码节假日数组，比如
date IN ('2024-02-10', '2024-02-11', ...)，后期根本没法审计和复用
如何 JOIN 日历表做考勤分组统计
考勤主表（如 attendance）通常有 emp_id、check_date、status（如 'normal'/'late'/'absent'）等字段。要按“工作日/节假日/调休日”分组，必须 LEFT JOIN calendar 表，而不是用子查询或相关子查询——后者在数据量大时性能断崖下跌。
SELECT c.is_workday, c.holiday_name, COUNT(*) AS total_records, COUNT(CASE WHEN a.status = 'normal' THEN 1 END) AS on_time FROM attendance a LEFT JOIN calendar c ON a.check_date = c.date GROUP BY c.is_workday, c.holiday_name;
注意：如果某天没出现在 calendar 表里（比如新插入的考勤记录还没同步日历），c.is_workday 和 c.holiday_name 都会是 NULL，这类数据得单独处理或补全日历。
- JOIN 条件必须是
a.check_date = c.date，别用DATE(a.check_in_time)这种函数包裹字段，会导致索引失效 - GROUP BY 里别只写
c.is_workday，否则不同节假日会被合并（比如春节和国庆都算is_workday=0） - 如果需要区分“周末”和“法定假日”，
calendar表得多加一列day_type（'weekend'/'holiday'/'workday'/'adjust'）
遇到跨年考勤或凌晨打卡怎么处理日期对齐
考勤系统常有凌晨打卡（如 2024-02-15 23:59 打卡，实际算 2024-02-16 出勤），这时 check_date 不能直接取打卡时间的 DATE，得按公司规则偏移。例如夜班以“下班时间”为准，则需 DATE(check_out_time)；若以“班次起始日”为准，就得查班次配置表关联计算。
错误做法是用 DATE_ADD(check_in_time, INTERVAL 4 HOUR) 这类魔法数字硬调——不同班次偏移不同，且夏令时可能出错。
- 真正可靠的方案是在考勤主表存一个
work_date字段，由应用层或触发器根据班次规则生成并写入，查询时直接 JOINcalendar表即可 - 如果只能从时间戳推算，优先用时区安全的函数：PostgreSQL 用
(check_in_time AT TIME ZONE 'Asia/Shanghai')::DATE，MySQL 8.0+ 用CONVERT_TZ(check_in_time, '+00:00', '+08:00') - 千万别用
DATE(check_in_time + INTERVAL 8 HOUR)这类表达式，UTC 时间加 8 小时在夏令时切换日可能错一天
为什么 GROUP BY 后 COUNT 总数不对
最常踩的坑是用了 COUNT(*) 却忘了 LEFT JOIN 导致的 NULL 行：当某条考勤记录的 check_date 在 calendar 表里不存在时，整行 JOIN 结果中 c.is_workday 为 NULL，但 COUNT(*) 仍会计数——这会让“未配置日历日”的统计混进结果，看起来总数对但分组失真。
- 检查是否真需要统计这些“日历缺失日”：不需要就加
WHERE c.date IS NOT NULL；需要就单独分组，比如GROUP BY COALESCE(c.is_workday, -1), COALESCE(c.holiday_name, 'missing') -
COUNT(column)会忽略 NULL，所以COUNT(c.is_workday)只计日历存在的天数，而COUNT(*)计所有考勤记录——这两个数差异就是日历漏配的天数 - 上线前务必用
SELECT * FROM attendance WHERE check_date NOT IN (SELECT date FROM calendar)扫一遍漏配数据
日历表不是辅助工具，是考勤统计的基石。少一次漏更新，后续所有分组结果都不可信——尤其调休日这种反直觉的“周日上班/周一放假”，必须靠人工核对后写进 calendar 表，算法绕不过去。
