CKTIS / Java
ZoneId.of: selecionar um fuso horário pelo identificador
Utiliza `ZoneId.of` para escolher um fuso horário regional ou um desfasamento fixo em relação a UTC e mostrar o mesmo instante em Varsóvia, Nova Iorque e Tóquio.
Versão: Java SE 21
Sintaxe
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) é um método de fábrica estático da classe java.time.ZoneId. Recebe um identificador não null e devolve um fuso cujas regras estão disponíveis no ambiente de execução. Por si só, não cria uma data nem uma hora.
Europe/Warsaw, America/New_York e Asia/Tokyo são identificadores regionais da base IANA TZDB usada por omissão. Respeita as maiúsculas e minúsculas. O desfasamento de um fuso regional depende das suas regras e do instante, pelo que pode mudar, por exemplo na passagem para a hora de verão. +02:00 e Z devolvem um ZoneOffset fixo. UTC, GMT e UT mantêm os seus identificadores com desfasamento zero; UTC+02:00 mantém o prefixo UTC e tem um desfasamento fixo.
ZoneId.of(String, Map<String, String>) substitui primeiro o identificador pelo valor associado, se o mapa contiver a chave correspondente, e depois resolve o identificador resultante como a sobrecarga de um argumento. O mapa não pode ser null. Para abreviaturas antigas, podes passar explicitamente ZoneId.SHORT_IDS. Não partas do princípio de que as abreviaturas são inequívocas ou de que a sobrecarga de um argumento utiliza este mapa.
Uma sintaxe inválida provoca DateTimeException; um identificador regional bem formado mas indisponível provoca ZoneRulesException, uma subclasse de DateTimeException. Trata estes erros explicitamente em vez de recorrer silenciosamente ao fuso horário predefinido. No exemplo, Instant.atZone cria um ZonedDateTime: muda a representação local, mas não o instante. Os identificadores regionais e as regras disponíveis dependem dos dados de fusos horários do ambiente de execução.
Exemplos
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));
}
}
}Resultado
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]
Cada linha mostra o mesmo instante fixo como data e hora locais, seguidas do desfasamento em relação a UTC e do identificador regional entre parênteses retos.
Lições relacionadas
- Java · Lição 59 · Intermédio · Versão: 2