Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

ZoneId — identifikátor časového pásma

ZoneId identifikuje časové pásmo, zatímco ZoneRules popisuje jeho pravidla posunu vůči UTC. Seznamte se s metodami ZoneId.of a ZoneId.getRules i s rozdílem mezi oblastí a pevným posunem.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();

java.time.ZoneId identifikuje časové pásmo; neukládá datum ani čas. ZoneId.of(String) vytvoří identifikátor oblasti, například Europe/Paris, nebo identifikátor pevného posunu, například +02:00. Oblast není totéž co pevný posun.

ZoneId.getRules() vrací ZoneRules. Jeho metoda getOffset(Instant) poskytuje posun pro konkrétní okamžik, zatímco isFixedOffset() ověřuje, zda se tento posun nikdy nemění. Pravidla oblastí mohou zahrnovat změny času a závisejí na datech dostupných v běhovém prostředí.

Pro Instant platí právě jeden použitelný posun. Při převodu LocalDateTime však může přechod mezi posuny způsobit mezeru nebo překryv místních časů. getValidOffsets(LocalDateTime) pomáhá tyto případy rozpoznat; nepředpokládejte, že místní čas vždy určuje jediný okamžik.

Neplatný formát předaný metodě ZoneId.of způsobí DateTimeException, zatímco neznámá oblast způsobí ZoneRulesException. ZoneId.getRules může také vyvolat ZoneRulesException, pokud pravidla nejsou dostupná. Příklad používá pevný posun a určený okamžik, takže jeho výsledek nezávisí na hodinách ani na aktualizacích dat oblastí.

Pří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ýsledek

+02:00
true
+02:00

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje