LocalTime.truncatedTo() 是 Java 8 提供的将时间截断到指定单位并归零更小单位的方法,支持 HOURS、MINUTES、SECONDS、MILLIS 等,不支持 DAYS;操作不可变、线程安全、语义清晰。

LocalTime.truncatedTo() 是 Java 8 引入的 java.time API 中一个简洁高效的方法,用于将时间“截断”到指定的时间单位,把更小单位的部分直接归零(不是四舍五入),适合做时间对齐、日志归档、统计分组等场景。
截断到小时:去掉分钟和秒
调用 truncatedTo(ChronoUnit.HOURS) 会保留小时,把分钟、秒、纳秒全部设为 0。
LocalTime now = LocalTime.of(14, 37, 52, 123_456_789); LocalTime truncatedToHour = now.truncatedTo(ChronoUnit.HOURS); // → 14:00:00
常见用途:统计每小时的请求量,或生成“整点时间戳”作为数据分区键。
截断到分钟:只保留小时和分钟
使用 truncatedTo(ChronoUnit.MINUTES),秒和纳秒归零,分钟及更大单位不变。
立即学习“Java免费学习笔记(深入)”;
LocalTime now = LocalTime.of(09, 15, 48, 999_000_000); LocalTime truncatedToMinute = now.truncatedTo(ChronoUnit.MINUTES); // → 09:15:00
适合需要按分钟粒度聚合的场景,比如监控系统中每分钟的平均响应时间。
支持的单位与注意事项
- 支持的单位包括:
ChronoUnit.HOURS、ChronoUnit.MINUTES、ChronoUnit.SECONDS、ChronoUnit.MILLIS等 - 不支持
DAYS或更粗粒度单位(因为LocalTime本身不包含日期信息) - 截断是单向归零操作,不会影响原始对象(
LocalTime是不可变的) - 若传入比当前精度更细的单位(如对
10:30截断到MILLIS),结果不变
与其他方式对比(为什么不用 minusSeconds()?)
有人会想到用 minusSeconds(getSecond()) 手动清空秒数,但这种方式:
- 代码冗长,且需额外处理纳秒
- 无法统一处理“到小时”或“到毫秒”等不同粒度
- 易出错(比如忘记减纳秒,或误用
plus) -
truncatedTo更语义清晰、线程安全、零开销


















