Java 没有关于所有 IANA 时区的信息

Java doesn't have information about all IANA time zones

我正在尝试将来自前端的值映射到 ZoneId class,如下所示:

Optional.ofNullable(timeZone).map(ZoneId::of).orElse(null)

对于大多数时区,它工作正常,但是,对于某些值 Java 抛出异常:

java.time.zone.ZoneRulesException: Unknown time-zone ID: America/Punta_Arenas

但是,根据 IANA,它是一个有效时区: https://www.iana.org/time-zones

Zone America/Punta_Arenas -4:43:40 - LMT 1890

我正在考虑对这样的时区使用偏移量(只是为了硬编码值),但我想应该有更方便的方法来解决这个问题。 Java 有办法解决吗?

不支持的其他时区:

我的 Java 版本:“1.8.0_121” Java(TM) SE Runtime Environment (build 1.8.0_121-b13) Java HotSpot(TM) 64 位服务器 VM(内部版本 25.121-b13,混合模式)

我已经用 Java 1.8 进行了测试。0_121 并且确实缺少一些区域。

最明显的修复方法是更新 Java 的版本 - 在 Java 1.8 中。0_131 以上所有区域都可用 - 除了 3 个字母的名称(ESTHST 等),更多内容见下文。

但我知道生产环境中的更新并不像我们希望的那样容易(也不快)。在这种情况下,您可以使用 TZUpdater tool,它可以在不更改 Java 的版本的情况下更新 JDK 的时区数据。


唯一的细节是 ZoneId 不适用于 3 个字母的缩写(ESTHST 等等)。那是因为这些名字是 ambiguous and not standard.

不过,如果您想使用它们,您可以使用自定义 ID 的映射。 ZoneId自带内置地图:

ZoneId.of("EST", ZoneId.SHORT_IDS);

问题是 choices used in the SHORT_IDS map 与任何其他选择一样,是武断的,甚至是有争议的。如果您想为每个缩写使用不同的区域,只需创建您自己的地图:

Map<String, String> map = new HashMap<>();
map.put("EST", "America/New_York");
... put how many names you want
System.out.println(ZoneId.of("EST", map)); // creates America/New_York

3 字母名称的唯一例外当然是 GMTUTC,但在这种情况下最好只使用 ZoneOffset.UTC 常量。


如果您无法更新您的 Java 版本或 运行 TZUpdater 工具,还有另一种(更难)替代方法。

您可以扩展 java.time.zone.ZoneRulesProvider class 并创建一个可以创建缺失 ID 的提供程序。类似的东西:

public class MissingZonesProvider extends ZoneRulesProvider {

    private Set<String> missingIds = new HashSet<>();

    public MissingZonesProvider() {
        missingIds.add("America/Punta_Arenas");
        missingIds.add("Europe/Saratov");
        // add all others
    }

    @Override
    protected Set<String> provideZoneIds() {
        return this.missingIds;
    }

    @Override
    protected ZoneRules provideRules(String zoneId, boolean forCaching) {
        ZoneRules rules = null;
        if ("America/Punta_Arenas".equals(zoneId)) {
            rules = // create rules for America/Punta_Arenas
        }
        if ("Europe/Saratov".equals(zoneId)) {
            rules = // create rules for Europe/Saratov
        }
        // and so on

        return rules;
    }

    // returns a map with the ZoneRules, check javadoc for more details
    @Override
    protected NavigableMap<String, ZoneRules> provideVersions(String zoneId) {
        TreeMap<String, ZoneRules> map = new TreeMap<>();
        ZoneRules rules = provideRules(zoneId, false);
        if (rules != null) {
            map.put(zoneId, rules);
        }
        return map;
    }
}

创建 ZoneRules 是最复杂的部分。

一种方法是获取最新的 IANA files and read them. You can take a look at JDK source code 以查看它如何从中创建 ZoneRules(尽管我不确定 JDK 中的文件是否准确与 IANA 文件的格式相同)。

无论如何,this link explains how to read IANA's files. Then you can take a look at ZoneRules javadoc to know how to map IANA information to Java classes. In 我创建了一个非常简单的 ZoneRules,只有 2 个转换规则,因此您可以基本了解如何做。

然后您需要注册提供商:

ZoneRulesProvider.registerProvider(new MissingZonesProvider());

现在新区域将可用:

ZoneId.of("America/Punta_Arenas");
ZoneId.of("Europe/Saratov");
... and any other you added in the MissingZonesProvider class

还有其他方法可以使用提供程序(而不是注册),check the javadoc了解更多详细信息。在同一个 javadoc 中还有更多关于如何正确实现区域规则提供程序的详细信息(我上面的版本非常简单,可能缺少一些细节,比如 provideVersions 的实现 - 它应该使用提供程序的版本作为密钥,而不是我正在做的区域 ID 等)。

当然,一旦您更新 Java 版本,就必须丢弃此提供程序(因为您不能让 2 个提供程序创建具有相同 ID 的区域:如果新提供程序创建的 ID 已经存在,当你尝试注册它时它会抛出异常。