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

CKTIS / Java

ZoneId.of: výber časového pásma podľa identifikátora

Pomocou `ZoneId.of` vyberte regionálne časové pásmo alebo pevný posun voči UTC a zobrazte ten istý okamih vo Varšave, New Yorku a Tokiu.

Verzia: Java SE 21

Syntax

import java.time.ZoneId;
import java.util.Map;

// Static method signatures in java.time.ZoneId:
public static ZoneId of(String zoneId)
public static ZoneId of(String zoneId, Map<String, String> aliasMap)

// Example calls:
ZoneId.of("Europe/Warsaw")
ZoneId.of("+02:00")
ZoneId.of("office", Map.of("office", "Europe/Warsaw"))

ZoneId.of(String) je statická továrenská metóda triedy java.time.ZoneId. Prijíma identifikátor, ktorý nie je null, a vracia pásmo, ktorého pravidlá sú dostupné v behovom prostredí. Sama nevytvára dátum ani čas.

Europe/Warsaw, America/New_York a Asia/Tokyo sú regionálne identifikátory z predvolenej databázy IANA TZDB. Zachovajte veľkosť písmen. Posun regionálneho pásma závisí od jeho pravidiel a daného okamihu, takže sa môže meniť, napríklad pri prechode na letný čas. +02:00 a Z vracajú pevný ZoneOffset. UTC, GMT a UT si zachovávajú svoj identifikátor s nulovým posunom; UTC+02:00 si zachováva predponu UTC a má pevný posun.

ZoneId.of(String, Map<String, String>) najprv nahradí identifikátor priradenou hodnotou, ak mapa obsahuje zodpovedajúci kľúč. Výsledný identifikátor potom spracuje rovnako ako preťažená metóda s jedným argumentom. Mapa nesmie byť null. Pre staršie skratky môžete výslovne odovzdať ZoneId.SHORT_IDS. Nepredpokladajte, že skratky sú jednoznačné alebo že verzia s jedným argumentom túto mapu používa.

Neplatný zápis spôsobí výnimku DateTimeException; správne zapísaný, ale nedostupný regionálny identifikátor spôsobí ZoneRulesException, podtriedu DateTimeException. Tieto chyby ošetrite výslovne namiesto tichého použitia predvoleného pásma. V príklade Instant.atZone vytvára ZonedDateTime: miestne vyjadrenie sa zmení, ale okamih zostáva rovnaký. Dostupné regionálne identifikátory a pravidlá závisia od údajov o časových pásmach v behovom prostredí.

Príklady

import java.time.Instant;
import java.time.ZoneId;

public class ZoneIdExample {
    public static void main(String[] args) {
        Instant instant = Instant.parse("2024-07-01T12:00:00Z");
        String[] zoneIds = {"Europe/Warsaw", "America/New_York", "Asia/Tokyo"};

        for (String id : zoneIds) {
            ZoneId zone = ZoneId.of(id);
            System.out.println(instant.atZone(zone));
        }
    }
}

Výsledok

2024-07-01T14:00+02:00[Europe/Warsaw]
2024-07-01T08:00-04:00[America/New_York]
2024-07-01T21:00+09:00[Asia/Tokyo]

Každý riadok zobrazuje ten istý pevne určený okamih ako miestny dátum a čas, za ktorými nasleduje posun voči UTC a identifikátor regiónu v hranatých zátvorkách.

Súvisiace lekcie

  • Java · Lekcia 59 · Stredne pokročilá · Verzia: 2

Zdroje