CKTIS / Java
ZoneId.of: избор на часова зона по идентификатор
Използвайте `ZoneId.of`, за да изберете регионална часова зона или фиксирано отместване спрямо UTC и да покажете един и същ момент във Варшава, Ню Йорк и Токио.
Версия: Java SE 21
Синтаксис
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) е статичен фабричен метод на класа java.time.ZoneId. Той приема идентификатор, различен от null, и връща зона, чиито правила са налични в средата за изпълнение. Сам по себе си методът не създава дата или час.
Europe/Warsaw, America/New_York и Asia/Tokyo са регионални идентификатори от базата IANA TZDB, използвана по подразбиране. Спазвайте регистъра на буквите. Отместването на регионална зона зависи от нейните правила и от конкретния момент и може да се променя, например при преминаване към лятно часово време. +02:00 и Z връщат фиксиран ZoneOffset. UTC, GMT и UT запазват идентификаторите си при нулево отместване; UTC+02:00 запазва префикса UTC и има фиксирано отместване.
ZoneId.of(String, Map<String, String>) първо заменя идентификатора със съответната стойност, ако в картата има такъв ключ, и след това обработва получения идентификатор като варианта с един аргумент. Картата не може да бъде null. За по-стари съкращения можете изрично да подадете ZoneId.SHORT_IDS. Не приемайте, че съкращенията са еднозначни или че вариантът с един аргумент използва тази карта.
Невалидният запис води до DateTimeException, а правилно записан, но неналичен регионален идентификатор води до ZoneRulesException, подклас на DateTimeException. Обработвайте тези грешки изрично, вместо без предупреждение да преминавате към зоната по подразбиране. В примера Instant.atZone създава ZonedDateTime: местното представяне се променя, но моментът остава същият. Наличните регионални идентификатори и правила зависят от данните за часови зони в средата за изпълнение.
Примери
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));
}
}
}Резултат
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]
Всеки ред показва един и същ предварително зададен момент като местна дата и час, следвани от отместването спрямо UTC и регионалния идентификатор в квадратни скоби.
Свързани уроци
- Java · Урок 59 · Средно · Версия: 2