CKTIS / Java
ZonedDateTime — data e hora com fuso horário
ZonedDateTime combina uma data e hora locais, um fuso horário e um desvio UTC resolvido. Distingue entre mudar de fuso mantendo o instante e manter a hora local, e trata as ambiguidades causadas pelas mudanças da hora.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
ZonedDateTime.of(localDateTime, zone)
ZonedDateTime.ofInstant(instant, zone)
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset)
zdt.withZoneSameInstant(zone)
zdt.withZoneSameLocal(zone)
zdt.toInstant()
zdt.format(formatter)
zdt.with(adjuster)
zdt.with(field, value)
zdt.withHour(hour)
zdt.withMinute(minute)ZonedDateTime é um valor de data e hora ISO imutável e seguro para utilização entre threads, com um ZoneId e um ZoneOffset. Um fuso regional define regras para as mudanças do desvio; um desvio fixo não tem essas mudanças.
ZonedDateTime.of cria um valor a partir de uma data e hora locais e de um fuso. Num intervalo inexistente, adianta a hora pela duração desse intervalo; numa sobreposição, escolhe o desvio anterior. ZonedDateTime.ofLocal também aceita um desvio preferido: utiliza-o se for válido, caso contrário escolhe o anterior; null significa que não existe preferência. Resolve os intervalos inexistentes da mesma forma. ZonedDateTime.ofInstant(instant, zone) mantém o instante indicado sem esta ambiguidade.
ZonedDateTime.withZoneSameInstant mantém o instante e, normalmente, altera a hora local. ZonedDateTime.withZoneSameLocal mantém, se possível, a data e hora locais, aplicando as regras de ofLocal; pode alterar o instante. ZonedDateTime.toInstant devolve apenas o instante, sem o identificador do fuso, enquanto ZonedDateTime.format formata o valor com um DateTimeFormatter.
ZonedDateTime.with(adjuster) aplica um TemporalAdjuster, enquanto ZonedDateTime.with(field, value) define um campo. ZonedDateTime.withHour define a hora entre 0 e 23, e ZonedDateTime.withMinute os minutos entre 0 e 59. Guarde o valor devolvido: o original não se altera. As alterações locais da hora ou dos minutos também seguem as regras para intervalos inexistentes e sobreposições; não significam adicionar uma duração decorrida.
Exemplos
import java.time.*;
import java.time.format.DateTimeFormatter;
public class Main {
public static void main(String[] args) {
ZoneId source = ZoneOffset.ofHours(1);
ZoneId target = ZoneOffset.ofHours(-5);
LocalDateTime local = LocalDateTime.of(2024, 1, 15, 12, 0);
ZonedDateTime original = ZonedDateTime.of(local, source);
ZonedDateTime sameInstant = original.withZoneSameInstant(target);
ZonedDateTime sameLocal = original.withZoneSameLocal(target);
System.out.println(sameInstant.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
System.out.println(sameLocal.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
System.out.println(original.toInstant().equals(sameInstant.toInstant()));
System.out.println(original.toInstant().equals(sameLocal.toInstant()));
}
}Resultado
2024-01-15T06:00:00-05:00 2024-01-15T12:00:00-05:00 true false
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.