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

CKTIS / Java

ZoneId.of a ZoneId.getRules: pravidla časových pásem

Zjisti posuny vůči UTC ve Varšavě a New Yorku ve stejném okamžiku v roce 2025 a ověř si, proč pevný posun nenahradí regionální časové pásmo.

Verze: Java SE 21

Syntaxe

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()

Statická tovární metoda ZoneId.of(String) z balíčku java.time ověří identifikátor a vrátí ZoneId. Europe/Warsaw a America/New_York označují regionální pásma; +01:00 vrátí ZoneOffset, tedy pevný posun vůči UTC. Shodný posun v jednom okamžiku neznamená shodná pravidla.

Přetížená varianta ZoneId.of(String, Map<String, String>) umožňuje dodat vlastní mapu aliasů na identifikátory pásem. Místo nejednoznačných zkratek používej regionální identifikátory. Neplatný formát vyvolá DateTimeException, zatímco správně zapsaný, ale neznámý regionální identifikátor vyvolá ZoneRulesException, podtyp DateTimeException.

Instanční metoda ZoneId.getRules() vrátí neměnný objekt java.time.zone.ZoneRules. getOffset(Instant) vrátí jediný posun platný v daném okamžiku. Pro LocalDateTime použij getValidOffsets: vrátí nula posunů v přeskočeném intervalu při posunu hodin dopředu, jeden mimo přechod a zpravidla dva v opakovaném intervalu při posunu hodin zpět. Pokud se hodiny posunou zpět dvakrát krátce po sobě, mohou teoreticky existovat i více než dva platné posuny. V přeskočeném nebo opakovaném intervalu vrací getOffset(LocalDateTime) posun před přechodem; v přeskočeném intervalu není pro zadaný místní čas platný.

Regionální pravidla dodává ZoneRulesProvider; výchozím zdrojem dat je IANA TZDB. Historické výsledky závisí na datech běhového prostředí. Poskytovatel s podporou dynamických aktualizací může při pozdějším volání getRules() vrátit jiná pravidla. Pokud pravidla pro deserializovaný identifikátor nejsou dostupná, getRules() vyvolá ZoneRulesException.

Příklady

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));
        }
    }
}

Výsledek

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

Každý řádek porovnává stejný okamžik v UTC. Dne 15. března 2025 už v New Yorku platí letní čas, ve Varšavě ještě ne. K 1. dubnu se posun změnil i ve Varšavě; pevný posun `+01:00` se nemění.

Související lekce

  • Java · Lekce 60 · Pokročilá · Verze: 2

Zdroje