CKTIS / Java
ZoneId — um identificador de fuso horário
ZoneId identifica um fuso horário, enquanto ZoneRules descreve as respetivas regras de desvio em relação a UTC. Aprende ZoneId.of, ZoneId.getRules e a diferença entre uma região e um desvio fixo.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();java.time.ZoneId identifica um fuso horário; não armazena uma data nem uma hora. ZoneId.of(String) cria um identificador de região, como Europe/Paris, ou de desvio fixo, como +02:00. Uma região não é o mesmo que um desvio fixo.
ZoneId.getRules() devolve ZoneRules. O método getOffset(Instant) fornece o desvio aplicável a um instante específico, enquanto isFixedOffset() verifica se esse desvio nunca muda. As regras regionais podem incluir mudanças da hora e dependem dos dados disponíveis no ambiente de execução.
A um Instant corresponde um único desvio aplicável. No entanto, ao converter um LocalDateTime, uma transição de desvio pode criar uma lacuna ou uma sobreposição nas horas locais. getValidOffsets(LocalDateTime) ajuda a identificar estes casos; não partas do princípio de que uma hora local identifica sempre um único instante.
Um formato inválido passado a ZoneId.of provoca DateTimeException, enquanto uma região desconhecida provoca ZoneRulesException. ZoneId.getRules também pode lançar ZoneRulesException se as regras não estiverem disponíveis. O exemplo utiliza um desvio fixo e um instante definido, para que o resultado não dependa do relógio nem de atualizações dos dados regionais.
Exemplos
import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;
public class Main {
public static void main(String[] args) {
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();
Instant instant = Instant.parse("2024-01-15T12:00:00Z");
System.out.println(zone.getId());
System.out.println(rules.isFixedOffset());
System.out.println(rules.getOffset(instant));
}
}Resultado
+02:00 true +02:00
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.