CKTIS / Java
ZonedDateTime — fecha y hora con zona horaria
ZonedDateTime combina una fecha y hora locales, una zona y un desplazamiento UTC resuelto. Distingue entre cambiar de zona conservando el instante y conservar la hora local, y gestiona las ambigüedades causadas por los cambios de hora.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
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 es un valor de fecha y hora ISO inmutable y seguro para usar entre hilos, con un ZoneId y un ZoneOffset. Una zona regional define reglas para los cambios de desplazamiento; un desplazamiento fijo no tiene esos cambios.
ZonedDateTime.of crea un valor a partir de una fecha y hora locales y una zona. En un intervalo inexistente adelanta la hora la duración de dicho intervalo; en un solapamiento elige el desplazamiento anterior. ZonedDateTime.ofLocal también acepta un desplazamiento preferido: lo usa si es válido y, si no, elige el anterior; null significa que no hay preferencia. Resuelve los intervalos inexistentes del mismo modo. ZonedDateTime.ofInstant(instant, zone) conserva el instante indicado sin esta ambigüedad.
ZonedDateTime.withZoneSameInstant conserva el instante y normalmente cambia la hora local. ZonedDateTime.withZoneSameLocal conserva, si es posible, la fecha y hora locales y aplica las reglas de ofLocal; puede cambiar el instante. ZonedDateTime.toInstant devuelve únicamente el instante, sin el identificador de zona, mientras que ZonedDateTime.format da formato al valor mediante un DateTimeFormatter.
ZonedDateTime.with(adjuster) aplica un TemporalAdjuster, mientras que ZonedDateTime.with(field, value) establece un campo. ZonedDateTime.withHour establece la hora entre 0 y 23, y ZonedDateTime.withMinute los minutos entre 0 y 59. Conserva el valor devuelto: el original no cambia. Los cambios locales de hora o minuto también siguen las reglas de intervalos inexistentes y solapamientos; no equivalen a añadir una duración transcurrida.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.