为何Clock.tick方法在Duration超60分钟时结果不符合预期？

测试场景 #

先看测试代码：

Clock clock = Clock.fixed(Instant.parse("2023-05-04T01:20:20Z"), ZoneId.systemDefault());
Clock tick = Clock.tick(clock, Duration.ofMinutes(3));
System.out.println(clock.instant());
System.out.println(tick.instant());

当Duration为3分钟时，输出符合预期：

2023-05-04T01:20:20Z
2023-05-04T01:18:00Z

但将Duration改为Duration.ofMinutes(61)后，输出变为：

2023-05-04T01:20:20Z
2023-05-04T00:40:00Z

根据Clock类的文档描述：

获取一个时钟，该时钟返回从指定时钟截断至最近指定Duration时间点的时刻。

疑问：为何结果不是2023-05-04T00:01:00Z或2023-05-04T01:01:00Z？

问题核心：Clock.tick的取整逻辑基于纪元时间 #

Clock.tick的“截断至最近指定Duration时间点”，不是以自然时间的整点/固定时刻为起点计算周期倍数，而是从**纪元时间（1970-01-01T00:00:00Z）**开始，将目标时间的总秒数对指定Duration的总秒数取模，再用目标时间减去这个模值，得到截断后的时间。

我们通过计算验证：

1. 目标时间2023-05-04T01:20:20Z对应的纪元总秒数：1683151220
2. 61分钟对应的总秒数：61*60=3660秒
3. 取模计算：1683151220 % 3660 = 2620秒（即43分40秒）
4. 截断后时间 = 目标时间 - 模值：1683151220 - 2620 = 1683148600，转换为Instant就是2023-05-04T00:40:00Z，和实际输出完全一致。

你之前误以为是按“每61分钟从整点开始算周期”（比如00:01、01:02这类时刻），但实际上Clock.tick的逻辑是基于时间戳的数学取整，而非自然时间的周期对齐。文档里的“最近指定Duration时间点”，指的是从纪元开始，每经过一个指定Duration就标记一个时间点，目标时间会被截断到离它最近且不晚于它的那个标记点。

内容的提问来源于stack exchange，提问作者wang junweiiii