CKTIS / Java
ZoneId — identifikátor časového pásma
ZoneId identifikuje časové pásmo, zatiaľ čo ZoneRules opisuje jeho pravidlá posunu voči UTC. Spoznajte ZoneId.of, ZoneId.getRules a rozdiel medzi regiónom a pevným posunom.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();java.time.ZoneId identifikuje časové pásmo; neukladá dátum ani čas. ZoneId.of(String) vytvorí identifikátor regiónu, napríklad Europe/Paris, alebo identifikátor pevného posunu, napríklad +02:00. Región nie je to isté ako pevný posun.
ZoneId.getRules() vracia ZoneRules. Jeho metóda getOffset(Instant) poskytuje posun pre konkrétny okamih, zatiaľ čo isFixedOffset() overuje, či sa tento posun nikdy nemení. Pravidlá regiónov môžu zahŕňať zmeny času a závisia od údajov dostupných v prostredí behu.
Pre Instant platí práve jeden použiteľný posun. Pri prevode LocalDateTime však môže prechod medzi posunmi spôsobiť medzeru alebo prekrytie miestnych časov. getValidOffsets(LocalDateTime) pomáha tieto prípady rozpoznať; nepredpokladajte, že miestny čas vždy určuje jediný okamih.
Neplatný formát odovzdaný metóde ZoneId.of spôsobí DateTimeException, zatiaľ čo neznámy región spôsobí ZoneRulesException. ZoneId.getRules môže tiež vyvolať ZoneRulesException, ak pravidlá nie sú dostupné. Príklad používa pevný posun a určený okamih, takže jeho výstup nezávisí od hodín ani od aktualizácií údajov regiónov.
Príklady
import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;
public class Main {
public static void main(String[] args) {
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();
Instant instant = Instant.parse("2024-01-15T12:00:00Z");
System.out.println(zone.getId());
System.out.println(rules.isFixedOffset());
System.out.println(rules.getOffset(instant));
}
}Výsledok
+02:00 true +02:00
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.