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.OffsetDateTimeOffsetDateTime 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.