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