CKTIS / Java
ZoneOffset — um desvio fixo em relação a UTC
ZoneOffset descreve um desvio fixo em relação a UTC, não as regras de um fuso horário regional. ZoneOffset.UTC representa o desvio zero, cujo identificador é Z.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
ZoneOffset.UTC
ZoneOffset.of("+02:00")
ZoneOffset.ofHoursMinutes(-5, -30)
offset.getId()
offset.getTotalSeconds()java.time.ZoneOffset representa uma diferença fixa em relação a UTC, por exemplo, +02:00. Não armazena uma data nem uma hora. Um ZoneId regional, como Europe/Paris, define regras para determinar o desvio num dado instante; um desvio, por si só, não descreve as alterações da hora de verão.
ZoneOffset.UTC representa o desvio zero; getId() devolve Z para esse valor. Métodos de fábrica como of("+02:00") e ofHoursMinutes(-5, -30) criam outros valores. Os componentes diferentes de zero têm de ter o mesmo sinal. O intervalo vai de -18:00 a +18:00, inclusive; um valor inválido provoca uma DateTimeException.
As instâncias são imutáveis e seguras para utilização por várias threads. Compara-as com equals, não com ==, e não as uses como bloqueios de sincronização. O exemplo mostra identificadores normalizados, um desvio em segundos e a igualdade entre duas representações do desvio zero.
Exemplos
import java.time.ZoneOffset;
public class Main {
public static void main(String[] args) {
ZoneOffset offset = ZoneOffset.ofHoursMinutes(-5, -30);
System.out.println(ZoneOffset.UTC.getId());
System.out.println(offset.getId());
System.out.println(offset.getTotalSeconds());
System.out.println(ZoneOffset.UTC.equals(ZoneOffset.of("+00:00")));
}
}Resultado
Z -05:30 -19800 true
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.