LocalTime专为“几点几分”设计,勿混用LocalDateTime或字符串拼接;解析需指定格式如"HH:mm";跨日区间判断需先判start.isAfter(end),再用isAfter(start)||isBefore(end);数据库映射须匹配TIME类型,JSON序列化需@JsonFormat指定pattern。

直接用 LocalTime,别碰 LocalDateTime 或字符串拼接——它就是专为“几点几分”这类场景设计的,强行加日期或转字符串,后续跨日比较、数据库映射、JSON 序列化全会出问题。
创建和解析时为什么总抛 DateTimeException
LocalTime 对输入极其严格:小时必须是 0–23,分钟/秒必须是 0–59,且默认 parse() 只认 "HH:mm:ss" 格式。传 "14:30" 或 "2:30 PM" 都会直接炸。
- 固定格式(如前端传
"HH:mm:ss"):显式配DateTimeFormatter.ofPattern("HH:mm:ss"),别依赖默认 - 需要支持
"HH:mm":用LocalTime.parse("14:30", DateTimeFormatter.ofPattern("HH:mm")) - 从整数字段还原(比如数据库存的是秒数 54000):优先用
LocalTime.ofSecondOfDay(54000),比手动拆小时分钟更安全 - 避免绕路写法:别用
new Date().toInstant().atZone(...).toLocalTime(),直接LocalTime.now()
跨日区间判断(比如夜班 22:00 到次日 6:00)怎么写才不翻车
纯时间没有“昨天”“明天”概念,isBefore/isAfter 在跨日区间里直接失效。比如 now.isAfter(start) && now.isBefore(end) 在 start=22:00、end=06:00 时永远返回 false。
- 先判断是否跨日:
if (start.isAfter(end)) - 再分两段写:
now.isAfter(start) || now.isBefore(end) - 别用
compareTo做区间判断——语义不清,容易漏边界 - 注意
LocalTime.MIN是00:00,LocalTime.MAX是23:59:59.999999999,不是24:00
和数据库、JSON 打交道时哪些配置不能少
JPA/Hibernate 默认把 LocalTime 映射成 TIME WITHOUT TIME ZONE(PostgreSQL)或 TIME(MySQL),看着没问题,但实际常踩两个坑:
- Spring Boot 的 Jackson 默认序列化成 ISO 字符串(如
"14:30:00"),如果前端要"HH:mm"或秒数,必须加@JsonFormat(pattern = "HH:mm") - MySQL 的
TIME类型能存负值(表示时间差),而LocalTime不能——遇到时长计算(如“提前了 15 分钟”),该换Duration就别硬扛 - 数据库字段类型必须匹配:千万别用
DATETIME或TIMESTAMP存LocalTime,否则多出的日期部分全是默认值,后续查出来是"1970-01-01T14:30:00"这种假数据
最易被忽略的一点:LocalTime 不能直接升格为带时区的时间。它没有时区信息,所以 .atZone() 会编译失败;想绑定时区,必须先补一个 LocalDate,再组合成 LocalDateTime,最后调 atZone() —— 这个“补日期”的动作本身就有业务含义,用 LocalDate.now() 不代表“任意一天”,而是“今天”。

















