怎么通过 LocalTime 处理不带日期的纯时间逻辑

怎么通过 LocalTime 处理不带日期的纯时间逻辑

处理“几点几分”这类纯时间逻辑，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)，这比手动拆分小时和分钟要安全得多。
• 获取当前时间：想获取当前时间？直接 LocalTime.now() 就行。避免绕远路，比如用 new Date().toInstant().atZone(...).toLocalTime() 这种写法，既啰嗦又容易出错。

跨日区间判断（比如夜班 22:00 到次日 6:00）怎么写才不翻车

纯时间没有“昨天”或“明天”的概念，这导致在处理跨日区间时，简单的 isBefore 和 isAfter 比较会直接失效。举个例子，假设现在是凌晨3点，你用 now.isAfter(start) && now.isBefore(end) 来判断是否在夜班时段（22:00到次日06:00），结果永远是 false。

• 先判断是否跨日：核心逻辑是，先看开始时间是否晚于结束时间：if (start.isAfter(end))。如果是，那就意味着这是一个跨越了午夜的区间。
• 再分两段判断：对于跨日区间，判断当前时间是否在区间内的正确写法是：now.isAfter(start) || now.isBefore(end)。这涵盖了从开始时间到午夜，以及从午夜到结束时间这两个时间段。
• 慎用 compareTo：别用 compareTo 来做区间判断，它的语义不够清晰，很容易漏掉边界情况。
• 注意时间边界：另外，LocalTime.MIN 是 00:00，而 LocalTime.MAX 是 23:59:59.999999999，并不是 24:00，这一点在边界计算时需要留意。

和数据库、JSON 打交道时哪些配置不能少

当 LocalTime 需要与数据库或JSON序列化打交道时，有几个配置点至关重要，一不留神就会踩坑。

• JSON序列化格式：Spring Boot 的 Jackson 默认会把 LocalTime 序列化成 ISO 格式的字符串（例如 "14:30:00"）。如果前端期望的是 "HH:mm" 格式或者直接是秒数，就必须在实体类字段上添加注解：@JsonFormat(pattern = "HH:mm")。
• 数据库类型匹配：JPA或Hibernate通常会将 LocalTime 映射为 TIME WITHOUT TIME ZONE（PostgreSQL）或 TIME（MySQL）。这里有个细节：MySQL的 TIME 类型可以存储负值（用来表示时间差），但 LocalTime 本身不支持。所以，如果业务涉及时长计算（比如“任务提前了15分钟”），应该考虑使用 Duration 类型，而不是强行用 LocalTime。
• 绝对要避开的坑：数据库字段类型必须严格匹配。千万不要用 DATETIME 或 TIMESTAMP 来存储 LocalTime。否则，多出来的日期部分会被填入默认值（比如1970-01-01），查询出来的数据就成了 "1970-01-01T14:30:00" 这种毫无意义的“假数据”。

最后，还有一个极易被忽略的点：LocalTime 本身不带时区信息，因此不能直接调用 .atZone() 方法（编译会失败）。如果想将其与特定时区绑定，必须先补上一个日期（LocalDate），组合成 LocalDateTime，然后再调用 atZone()。需要注意的是，这个“补日期”的动作本身就带有业务含义——使用 LocalDate.now() 意味着“今天”，而不是“任意一天”，这在设计逻辑时必须想清楚。