Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje