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

CKTIS / Java

time.OffsetDateTime: referência prática

time.OffsetDateTime: referência prática: OffsetDateTime junta data-hora ISO local e deslocamento UTC fixo, determinando assim um instante.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

java.time.OffsetDateTime

OffsetDateTime junta data-hora ISO local e deslocamento UTC fixo, determinando assim um instante.

Usa OffsetDateTime em dados de rede ou base de dados que tenham de preservar o deslocamento recebido.

Um deslocamento não contém regras sazonais regionais; equals inclui campos locais e offset, isEqual compara o instante.

withOffsetSameInstant mantém o instante, withOffsetSameLocal os campos locais; o limite é ±18:00.

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Exemplos

public class Main {
    public static void main(String[] args) throws Exception {
        var value = java.time.OffsetDateTime.parse("2024-01-01T12:00:00+02:00");
        System.out.println(value.toInstant());
    }
}

Resultado

2024-01-01T10:00:00Z

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Fontes