为何java.time.zone.ZoneRules仍需传入时区转换列表？

背景：ZoneRules#of参数说明 #

在Java 8及后续版本（如Java 21）中，java.time.zone.ZoneRules#of是创建自定义时区并通过ZoneRulesProvider提供的推荐静态工厂方法，它接收5个核心参数：

• baseStandardOffset：规则生效前日期使用的标准偏移量
• baseWallOffset：规则生效前日期使用的墙钟偏移量
• standardOffsetTransitionList：标准偏移量变更列表
• transitionsList：时区转换列表（夏令时/冬令时切换等）
• lastRules：最多16条可通过算法生成循环转换的规则

疑问：为什么有循环规则还需要transitionsList？ #

既然lastRules能通过算法生成指定日期后的下一次转换，为何transitionsList仍不能传空集合？传空会导致功能异常：

比如以下代码尝试创建一个夏令时时区：每年3月1日或之后首个周日从+02切换到+03，9月1日或之后首个周日从+03切换回+02。代码中传入了lastRules但transitionsList为空集合：

LocalDateTime startOfDst = LocalDateTime.of(2004, 3, 1, 3, 0);
LocalDateTime endOfDst = LocalDateTime.of(2004, 9, 1, 3, 0);
int summerOffset = 3;
int winterOffset = 2;
ZoneOffset winterZoneOffset = ZoneOffset.ofHours(winterOffset);
ZoneOffset summerZoneOffset = ZoneOffset.ofHours(summerOffset);

ZoneOffsetTransitionRule winterOffsetRule = ZoneOffsetTransitionRule.of(
        endOfDst.getMonth(),
        endOfDst.getDayOfMonth(),
        DayOfWeek.SUNDAY,
        endOfDst.toLocalTime(),
        false,
        TimeDefinition.UTC,
        winterZoneOffset,
        summerZoneOffset,
        winterZoneOffset
);

ZoneOffsetTransitionRule summerOffsetRule = ZoneOffsetTransitionRule.of(
        startOfDst.getMonth(),
        startOfDst.getDayOfMonth(),
        DayOfWeek.SUNDAY,
        startOfDst.toLocalTime(),
        false,
        TimeDefinition.UTC,
        winterZoneOffset,
        winterZoneOffset,
        summerZoneOffset
);

ZoneRules rules = ZoneRules.of(
        winterZoneOffset,
        winterZoneOffset,
        Collections.emptyList(),
        Collections.emptyList(),
        Arrays.asList(summerOffsetRule, winterOffsetRule)
);

此时调用rules.nextTransition(Instant.now())会返回null，原因是底层rules对象的savingsInstantTransitions字段未初始化（长度为0），而该字段仅在transitionsList至少有一个值时才会被初始化，相关源码片段如下：

public ZoneOffsetTransition nextTransition(Instant instant) {
    if (savingsInstantTransitions.length == 0) {
        return null;
    }
    // 后续转换计算逻辑
}

ZoneRules(ZoneOffset baseStandardOffset,
          ZoneOffset baseWallOffset,
          List<ZoneOffsetTransition> standardOffsetTransitionList,
          List<ZoneOffsetTransition> transitionList,
          List<ZoneOffsetTransitionRule> lastRules) {
    super();
    // 其他初始化逻辑
    // 将转换记录转为时间戳数组
    this.savingsInstantTransitions = new long[transitionList.size()];
    for (int i = 0; i < transitionList.size(); i++) {
        this.savingsInstantTransitions[i] = transitionList.get(i).toEpochSecond();
    }
    // 其他初始化逻辑
}

核心问题与解答 #

1. 是否可以无需转换历史生成自定义时区？ #

不能完全跳过transitionsList，但不需要传入完整的历史转换记录——只需要传入循环规则覆盖范围内的任意一个有效转换实例，就能触发后续循环规则的生效逻辑。

2. 正确定义循环规则时区的方法 #

解决思路：根据lastRules中的规则生成至少一个初始的ZoneOffsetTransition实例，传入transitionsList，触发savingsInstantTransitions初始化，让循环规则逻辑正常工作。

修改后的完整代码示例：

LocalDateTime startOfDst = LocalDateTime.of(2004, 3, 1, 3, 0);
LocalDateTime endOfDst = LocalDateTime.of(2004, 9, 1, 3, 0);
int summerOffset = 3;
int winterOffset = 2;
ZoneOffset winterZoneOffset = ZoneOffset.ofHours(winterOffset);
ZoneOffset summerZoneOffset = ZoneOffset.ofHours(summerOffset);

// 定义冬令时切换规则
ZoneOffsetTransitionRule winterOffsetRule = ZoneOffsetTransitionRule.of(
        endOfDst.getMonth(),
        endOfDst.getDayOfMonth(),
        DayOfWeek.SUNDAY,
        endOfDst.toLocalTime(),
        false,
        TimeDefinition.UTC,
        winterZoneOffset,
        summerZoneOffset,
        winterZoneOffset
);

// 定义夏令时切换规则
ZoneOffsetTransitionRule summerOffsetRule = ZoneOffsetTransitionRule.of(
        startOfDst.getMonth(),
        startOfDst.getDayOfMonth(),
        DayOfWeek.SUNDAY,
        startOfDst.toLocalTime(),
        false,
        TimeDefinition.UTC,
        winterZoneOffset,
        winterZoneOffset,
        summerZoneOffset
);

// 根据规则生成一个初始转换实例（比如2004年的夏令时转换）
ZoneOffsetTransition initialSummerTransition = summerOffsetRule.createTransition(2004);
// 生成另一个初始转换实例（2004年的冬令时转换）
ZoneOffsetTransition initialWinterTransition = winterOffsetRule.createTransition(2004);

// 传入初始转换列表，触发循环规则生效
ZoneRules rules = ZoneRules.of(
        winterZoneOffset,
        winterZoneOffset,
        Collections.emptyList(),
        Arrays.asList(initialSummerTransition, initialWinterTransition),
        Arrays.asList(summerOffsetRule, winterOffsetRule)
);

// 测试：获取下一次时区转换
Instant now = Instant.now();
ZoneOffsetTransition nextTransition = rules.nextTransition(now);
System.out.println("下一次时区转换：" + nextTransition); // 正常返回符合规则的转换记录

原理说明 #

• 传入初始转换实例后，savingsInstantTransitions会被正常初始化，nextTransition方法会跳过空值检查进入后续逻辑。
• 当遍历完初始转换记录后，代码会自动使用lastRules中的循环规则计算未来的所有转换。

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