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