База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

ZoneId.of и ZoneId.getRules: правила на часовите зони

Намери отместванията спрямо UTC във Варшава и Ню Йорк в един и същ момент през 2025 г. и виж защо фиксираното отместване не може да замени регионална часова зона.

Версия: Java SE 21

Синтаксис

java.time.ZoneId
  public static ZoneId of(String zoneId)
  public static ZoneId of(String zoneId, java.util.Map<String, String> aliasMap)
  public abstract java.time.zone.ZoneRules getRules()

Статичният фабричен метод ZoneId.of(String) от пакета java.time проверява идентификатора и връща ZoneId. Europe/Warsaw и America/New_York обозначават регионални часови зони, а +01:00 дава ZoneOffset, тоест фиксирано отместване спрямо UTC. Еднаквото отместване в един момент не означава еднакви правила.

Претовареният метод ZoneId.of(String, Map<String, String>) позволява да зададеш собствено съответствие между псевдоними и идентификатори на зони. Предпочитай регионалните идентификатори пред двусмислените съкращения. Невалидният формат води до DateTimeException, а правилно изписан, но непознат регионален идентификатор води до ZoneRulesException, подтип на DateTimeException.

Методът на екземпляра ZoneId.getRules() връща неизменяем обект java.time.zone.ZoneRules. getOffset(Instant) връща единственото отместване, което важи в този момент. За LocalDateTime използвай getValidOffsets: методът връща нула отмествания в пропуснатия интервал при преместване на часовника напред, едно извън преход и обикновено две в повторения интервал при връщане на часовника назад. На теория са възможни повече от две валидни отмествания, ако часовникът бъде върнат назад два пъти в кратък интервал. В пропуснат или повторен интервал getOffset(LocalDateTime) връща отместването отпреди прехода, което в пропуснатия интервал не е валидно за зададеното местно време.

Регионалните правила идват от ZoneRulesProvider; източникът на данни по подразбиране е IANA TZDB. Историческите резултати зависят от данните на средата за изпълнение. Доставчик с поддръжка на динамични обновявания може да върне други правила при следващо извикване на getRules(). Ако правилата за десериализиран идентификатор не са налични, getRules() хвърля ZoneRulesException.

Примери

import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;

public class Main {
    public static void main(String[] args) {
        ZoneRules warsaw = ZoneId.of("Europe/Warsaw").getRules();
        ZoneRules newYork = ZoneId.of("America/New_York").getRules();
        ZoneRules fixed = ZoneId.of("+01:00").getRules();

        System.out.println("UTC instant | Europe/Warsaw | America/New_York | fixed +01:00");
        for (String timestamp : new String[] {
                "2025-03-01T12:00:00Z", "2025-03-15T12:00:00Z", "2025-04-01T12:00:00Z"
        }) {
            Instant instant = Instant.parse(timestamp);
            System.out.println(instant + " | " + warsaw.getOffset(instant)
                    + " | " + newYork.getOffset(instant) + " | " + fixed.getOffset(instant));
        }
    }
}

Резултат

UTC instant | Europe/Warsaw | America/New_York | fixed +01:00
2025-03-01T12:00:00Z | +01:00 | -05:00 | +01:00
2025-03-15T12:00:00Z | +01:00 | -04:00 | +01:00
2025-04-01T12:00:00Z | +02:00 | -04:00 | +01:00

Всеки ред сравнява един и същ момент по UTC. На 15 март 2025 г. Ню Йорк вече е на лятно часово време, а Варшава все още не е. Към 1 април отместването във Варшава също се е променило; фиксираното `+01:00` остава същото.

Свързани уроци

  • Java · Урок 60 · Напреднало · Версия: 2

Източници