应到时间前打卡为正常，9:00–9:15打卡为弹性迟到，超9:15为硬性迟到；需分三支判断，不可合并阈值。
PHP中用strtotime()解析考勤时间容易出错
直接对“08:30”这类纯时间字符串调用strtotime()会默认补全为当天日期，导致跨天场景（如夜班、凌晨打卡）比对完全错误。比如凌晨02:00打卡，strtotime('02:00')返回的是今天凌晨而非昨天或系统设定的考勤日边界。
正确做法是先明确考勤日的起止时间点（如以05:00为日界），再把打卡时间绑定到对应日期上：
- 获取打卡原始时间字符串（如
$punch_time = '02:15'） - 用
date('Y-m-d', strtotime('-1 day'))或业务规则确定所属考勤日$work_date - 拼接：
$punch_ts = strtotime($work_date . ' ' . $punch_time) - 对比时统一用
int类型时间戳，避免DateTime对象隐式转换差异
迟到判定必须区分“应到时间”和“弹性时间窗”
硬性迟到（如9:00前未打卡即算）和弹性迟到（如9:00–9:15打卡只扣分不计迟到）在代码里要拆成两个判断分支，不能合并为一个阈值比较。
常见错误是写成if ($punch_ts > strtotime('09:00')) { // 迟到 }——这会把9:05和10:30都归为同一类，无法支持分级处理。
立即学习“PHP免费学习笔记（深入）”；
- 定义两个基准时间戳：
$on_time = strtotime($date . ' 09:00')（应到）、$late_limit = strtotime($date . ' 09:15')（弹性截止） - 迟到等级判断顺序必须严格：先查是否
（正常），再查是否<code>（弹性迟到），最后才是严重迟到 - 注意服务器时区与业务时区一致，
date_default_timezone_set('Asia/Shanghai')不能漏
早退判定要防“当日未下班”误判
早退逻辑不能只看下班打卡时间是否早于规定时间，必须确认该员工当天有完整上下班记录。否则单次打卡（如只打了上午卡）会被误判为“17:00前打卡=早退”。
- 先查数据库是否存在同日
check_type = 'out'且status = 'success'的记录 - 仅当存在有效下班卡时，才执行
if ($out_ts - 若无下班卡，状态应为“缺卡”或“未签退”，而非早退——这点在报表统计中极易混淆
- 时间戳比对前务必用
is_numeric($out_ts) && $out_ts > 0过滤无效值，防止strtotime('')返回false引发警告
MySQL存时间戳还是DATETIME？关键看查询模式
如果考勤查询大量依赖“某天所有打卡”“某人本月迟到次数”这类日期范围扫描，用DATETIME字段配合DATE(punch_time)索引更稳；若频繁做UNIX_TIMESTAMP()运算或跨时区转换，存INT UNSIGNED时间戳反而增加PHP层负担。
- 存
DATETIME：查询语句干净，WHERE punch_time BETWEEN '2024-06-01' AND '2024-06-01 23:59:59'可走索引 - 存
INT：PHP侧需统一用date('Y-m-d H:i:s', $ts)转格式，但排序、分组性能略优 - 绝对不要混用：PHP用
time()写入INT，SQL里又用NOW()写入DATETIME，会导致比对失效
真正麻烦的是夏令时切换日和跨年考勤日边界（如05:00日界遇上1月1日04:59），这些点必须在测试数据里显式覆盖，光靠逻辑推演容易漏。
