
java 8+ 的 java.time 类(如 zoneddatetime)是不可变的,调用 plusdays、withhour 等方法不会修改原对象,而是返回新实例;若未重新赋值给变量,时间值将保持不变。
java 8+ 的 java.time 类(如 zoneddatetime)是不可变的,调用 plusdays、withhour 等方法不会修改原对象,而是返回新实例;若未重新赋值给变量,时间值将保持不变。
ZonedDateTime 及整个 java.time API 的设计遵循不可变性原则(Immutable Design),这意味着所有“修改”操作(如 plusDays()、withHour()、withZoneSameInstant() 等)均不改变原有对象,而是创建并返回一个全新的、符合预期的时间点实例。这是线程安全、函数式编程友好且避免意外状态污染的关键设计。
在你的代码中:
val zdt: ZonedDateTime = ZonedDateTime.now() // ✅ 创建初始实例
println("${zdt.toInstant().toEpochMilli()}") // 输出当前毫秒值
zdt.plusDays(1) // ❌ 返回新 ZonedDateTime,但未保存!原 zdt 不变
println("${zdt.toInstant().toEpochMilli()}") // 仍输出原值 → 时间“没变”
zdt.withHour(0).withMinute(0).withSecond(0) // ❌ 链式调用结果被丢弃
println("${zdt.toInstant().toEpochMilli()}") // 依然不变
根本问题在于:你使用了 val 声明不可变变量,并且所有转换操作的结果都未被接收或赋值。
✅ 正确做法是:
- 使用
var声明可重新赋值的变量; - 显式将方法返回的新实例重新赋值给变量;
- 或采用链式调用一次性构建目标时间(推荐,更清晰、更安全):
var zdt = ZonedDateTime.now()
println("原始时间(UTC毫秒): ${zdt.toInstant().toEpochMilli()}")
zdt = zdt.plusDays(1) // ✅ 重新赋值
println("加1天后: ${zdt.toInstant().toEpochMilli()}")
zdt = zdt.withHour(0).withMinute(0).withSecond(0).withNano(0) // ✅ 归零到当日 00:00:00.000
println("归零后(当日0点): ${zdt.toInstant().toEpochMilli()}")
? 更优雅的写法(无需中间变量重赋值):
val result = ZonedDateTime.now()
.plusDays(1)
.withHour(0)
.withMinute(0)
.withSecond(0)
.withNano(0)
println("最终时间(UTC毫秒): ${result.toInstant().toEpochMilli()}")
⚠️ 注意事项:
-
plusDays(1)是按本地时区日历加一天(考虑夏令时切换),不是简单加 24×3600×1000 毫秒; - 若需严格按 UTC 时间轴偏移(如加 24 小时),应先转为
Instant再操作:zdt.toInstant().plus(Duration.ofHours(24)).atZone(zdt.zone); - 所有
withXxx()方法仅修改对应字段,不自动归零其他精度(如withHour(0)不影响分钟/秒/纳秒),建议显式调用.withNano(0)保证毫秒级精度一致。
总结:牢记 java.time 中一切都是“返回新对象”,没有就地修改。理解不可变性,是写出健壮、可预测时间逻辑的第一步。










