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

CKTIS / Java

ZoneId.of: výběr časového pásma podle identifikátoru

Pomocí `ZoneId.of` vyberte regionální časové pásmo nebo pevný posun vůči UTC a zobrazte tentýž okamžik ve Varšavě, New Yorku a Tokiu.

Verze: Java SE 21

Syntaxe

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ární metoda třídy java.time.ZoneId. Přijímá identifikátor, který není null, a vrací pásmo, jehož pravidla jsou v běhovém prostředí dostupná. Sama nevytváří datum ani čas.

Europe/Warsaw, America/New_York a Asia/Tokyo jsou regionální identifikátory z výchozí databáze IANA TZDB. Zachovejte velikost písmen. Posun regionálního pásma závisí na jeho pravidlech a konkrétním okamžiku, takže se může měnit, například při přechodu na letní čas. +02:00 a Z vracejí pevný ZoneOffset. UTC, GMT a UT si zachovávají svůj identifikátor s nulovým posunem; UTC+02:00 si zachovává předponu UTC a má pevný posun.

ZoneId.of(String, Map<String, String>) nejprve nahradí identifikátor přiřazenou hodnotou, pokud mapa obsahuje odpovídající klíč. Výsledný identifikátor pak vyhodnotí stejně jako přetížená metoda s jedním argumentem. Mapa nesmí být null. Pro starší zkratky můžete výslovně předat ZoneId.SHORT_IDS. Nepředpokládejte, že jsou zkratky jednoznačné nebo že varianta s jedním argumentem tuto mapu používá.

Neplatný zápis způsobí výjimku DateTimeException; správně zapsaný, ale nedostupný regionální identifikátor způsobí ZoneRulesException, která je podtřídou DateTimeException. Tyto chyby ošetřete výslovně místo tichého použití výchozího pásma. V ukázce Instant.atZone vytváří ZonedDateTime: místní vyjádření se změní, okamžik však zůstane stejný. Dostupné regionální identifikátory a pravidla závisejí na datech o časových pásmech v běhovém prostředí.

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

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ý řádek zobrazuje tentýž pevně daný okamžik jako místní datum a čas, za nimiž následuje posun vůči UTC a identifikátor regionu v hranatých závorkách.

Související lekce

  • Java · Lekce 59 · Středně pokročilá · Verze: 2

Zdroje