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

CKTIS / Java

ZoneId.of a ZoneId.getRules: pravidlá časových pásiem

Zisti posuny voči UTC vo Varšave a New Yorku v tom istom okamihu v roku 2025 a over si, prečo pevný posun nenahradí regionálne časové pásmo.

Verzia: Java SE 21

Syntax

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árenská metóda ZoneId.of(String) z balíka java.time overí identifikátor a vráti ZoneId. Europe/Warsaw a America/New_York označujú regionálne pásma; +01:00 dá ZoneOffset, teda pevný posun voči UTC. Rovnaký posun v jednom okamihu neznamená rovnaké pravidlá.

Preťažený variant ZoneId.of(String, Map<String, String>) umožňuje dodať vlastnú mapu aliasov na identifikátory pásiem. Používaj regionálne identifikátory namiesto nejednoznačných skratiek. Neplatný formát vyvolá DateTimeException; správne zapísaný, ale neznámy regionálny identifikátor vyvolá ZoneRulesException, podtyp DateTimeException.

Inštančná metóda ZoneId.getRules() vráti nemenný objekt java.time.zone.ZoneRules. getOffset(Instant) vráti jediný posun platný v danom okamihu. Pre LocalDateTime použi getValidOffsets: vráti nula posunov v preskočenom intervale pri posune hodín dopredu, jeden mimo prechodu a zvyčajne dva v opakovanom intervale pri posune hodín späť. Ak sa hodiny posunú späť dvakrát krátko po sebe, teoreticky môžu byť platné aj viac než dva posuny. V preskočenom alebo opakovanom intervale vráti getOffset(LocalDateTime) posun pred prechodom; v preskočenom intervale nie je pre zadaný miestny čas platný.

Regionálne pravidlá dodáva ZoneRulesProvider; predvoleným zdrojom údajov je IANA TZDB. Historické výsledky závisia od údajov behového prostredia. Poskytovateľ s podporou dynamických aktualizácií môže pri neskoršom volaní getRules() vrátiť iné pravidlá. Ak pravidlá pre deserializovaný identifikátor nie sú dostupné, getRules() vyvolá ZoneRulesException.

Prí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ýsledok

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ý riadok porovnáva ten istý okamih v UTC. Dňa 15. marca 2025 už v New Yorku platí letný čas, vo Varšave ešte nie. K 1. aprílu sa posun zmenil aj vo Varšave; pevný posun `+01:00` sa nemení.

Súvisiace lekcie

  • Java · Lekcia 60 · Pokročilá · Verzia: 2

Zdroje