Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes