Java 8的java.time包是员工考勤系统日期逻辑的核心，应使用LocalDateTime、LocalTime、LocalDate分别处理打卡时刻、上下班时间与日期统计，配合可配置WorkRule、外置节假日管理及按日归组聚合实现准确考勤计算。
用Java做员工考勤统计系统，核心不在界面或数据库，而在日期逻辑的准确表达——打卡时间、迟到早退判定、工时计算、节假日排除、月度汇总，每一步都依赖对Java日期API的合理选择和严谨处理。
别再用Date和Calendar硬扛
老项目里常见new Date()、Calendar.getInstance().add()这类写法，问题很多：线程不安全、月份从0开始易错、跨月计算容易溢出。Java 8引入的java.time包才是正解。
- 用
LocalDateTime表示无时区的打卡时刻（如“2024-05-20 08:27:15”） - 用
LocalTime定义标准上下班时间（如“09:00”，“18:00”） - 用
LocalDate处理日期维度统计（如“2024-05-01”当天出勤记录） - 跨天计算（如夜班00:30–08:30）用
Duration而非毫秒相减
迟到、早退、缺卡的判定逻辑要可配置
硬编码“8:30前打卡算正常”会很快被业务打脸。应把规则抽成对象：
- 定义
WorkRule类：含workStartTime、lateThreshold（允许迟到分钟数）、absentAfter（超时未打卡即旷工）等字段 - 一次打卡只对应一个规则（如白班/夜班），避免if-else堆叠
- 判定示例：
LocalTime actual = record.getCheckIn(); boolean late = actual.isAfter(workRule.getWorkStartTime().plusMinutes(workRule.getLateThreshold()));
节假日与调休必须外置管理
国家法定假日每年变，内部调休安排也常临时调整。切忌把节假日写死在代码里。
立即学习“Java免费学习笔记（深入）”；
- 建一张
holiday_config表，存date、type（0=工作日，1=休息日，2=调休上班） - 加载时缓存为
Map，查询O(1) - 统计出勤率时，先查该日类型：休息日打卡不计正常出勤，但调休日打卡需计入
- 注意节气、少数民族节日等特殊安排，预留
remark字段扩展
月度汇总的关键是“按日归组+聚合”
不要试图一条SQL查出每人每月全量统计。推荐分两步：
- 第一步：查出某员工当月所有打卡记录，按
LocalDate分组（用Collectors.groupingBy(r -> r.getCheckTime().toLocalDate())） - 第二步：对每日分组，调用单日分析方法（判断是否出勤、是否迟到、有效工时等），再累加到月度对象中
- 导出Excel时，日期列用
DateTimeFormatter.ofPattern("yyyy-MM-dd")格式化，避免Locale导致“5月20日”乱码
