LocalDateTime是学生签到时间记录的首选——不可变、线程安全、语义清晰；应避免Date、Calendar、System.currentTimeMillis()等易出错方式，用HashMap管理签到记录并结合Stream统计。
用 LocalDateTime 记录签到时间，别碰 Date 和 Calendar
学生签到必须精确到分钟（甚至秒），且要避免时区、线程安全和可读性问题。LocalDateTime 是 Java 8+ 的默认选择——它不可变、线程安全、语义清晰。用 new Date() 或 Calendar.getInstance() 会埋下隐式时区转换、格式化错乱、并发修改异常等坑。
- 签到时刻统一用
LocalDateTime.now()，不传时区参数（业务通常按本地系统时钟） - 若需存储到数据库，JDBC 4.2+ 支持直接绑定
LocalDateTime到TIMESTAMP字段，无需手动转Timestamp - 禁止用
System.currentTimeMillis()存 long 值再“自己算日期”——易出毫秒溢出、时区误判、调试困难
用 HashMap<string list>></string> 管理学生签到记录
键为学号（String），值为该生所有签到时间列表。不用 TreeMap 或 LinkedHashMap——除非你明确需要排序或插入顺序，否则纯哈希查找更快，且签到频次高、查询以学号为主。
- 初始化时指定合理初始容量，比如预估 500 名学生：
new HashMap(512)，避免频繁扩容 - 每次签到执行
map.computeIfAbsent(studentId, k -> new ArrayList()).add(LocalDateTime.now())，一行搞定“无则建、有则加” - 不要用
ConcurrentHashMap——除非系统真有高并发签到（如千人同时扫码），否则锁开销反超收益；单机应用用普通HashMap+ 业务层同步更轻量
判断是否迟到：用 LocalTime 比较上课时间，别用字符串截取或 SimpleDateFormat
上课时间通常是固定时刻（如 08:30），和签到时间的“时分”比即可，不需要完整日期。用 LocalTime 解析和比较，干净又可靠。
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 定义常量上课时间：
private static final LocalTime CLASS_START = LocalTime.of(8, 30) - 判断逻辑：
signTime.toLocalTime().isAfter(CLASS_START.plusMinutes(10))表示迟到超 10 分钟 - 避免把
LocalDateTime转成字符串再substring(11, 16)截取——既慢又脆弱（万一格式变了？） - 更别用
SimpleDateFormat解析“08:30”——它是非线程安全的，且解析字符串比直接构造LocalTime多绕三步
导出当日签到统计：用 Stream + Collectors.groupingBy 快速聚合
老师常要查“今天多少人签到、几人迟到、平均签到时间”。用 Stream 链式操作比手写 for 循环更直观、不易漏边界条件。
立即学习“Java免费学习笔记（深入）”；
- 先过滤当天数据：
records.values().stream().flatMap(List::stream).filter(dt -> dt.toLocalDate().equals(LocalDate.now())) - 按状态分组：
.collect(Collectors.groupingBy(dt -> isLate(dt) ? "late" : "onTime", Collectors.counting())) - 求最早签到时间：
.mapToLong(dt -> dt.atZone(ZoneId.systemDefault()).toInstant().toEpochMilli()).min()——注意这里必须转Instant才能比毫秒值，LocalDateTime本身不能直接比大小（无时区信息）
真正容易被忽略的是：统计时没考虑“同一学生多次签到”是否去重。如果业务允许一天多签，就按次数统计；如果只认首次，则要在 filter 后加 .distinct() 或改用 Map.merge 去重。这个逻辑错一点，报表就全偏了。
