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