CKTIS / Java
ZonedDateTime: ¿el mismo instante o la misma hora local?
Crea una fecha y hora con zona en Java 21, elige explícitamente cada aparición de una hora repetida y cambia de zona conservando el instante o la lectura del reloj.
Versión: Java SE 21
Sintaxis
java.time.ZonedDateTime — Java SE 21
public static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)
public static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
public static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
public static ZonedDateTime ofLocal(LocalDateTime localDateTime, ZoneId zone, ZoneOffset preferredOffset)
public ZonedDateTime withZoneSameInstant(ZoneId zone)
public ZonedDateTime withZoneSameLocal(ZoneId zone)java.time.ZonedDateTime combina una fecha y hora locales con un identificador de zona (ZoneId) y un desfase respecto a UTC (ZoneOffset). Un Instant es un punto en la línea temporal. La fecha y hora locales son las que muestran el calendario y el reloj; en una zona dada, esa lectura puede corresponder a dos instantes distintos.
ZonedDateTime.of es un método de fábrica estático con tres sobrecargas: acepta un LocalDateTime, un LocalDate y un LocalTime, o siete campos numéricos, siempre con un ZoneId. Si solo hay un desfase válido, lo usa. En un solapamiento (un intervalo local repetido), elige el desfase de la primera aparición. En un hueco (un intervalo que el reloj se salta), adelanta la fecha y hora locales en la duración del hueco y usa el desfase posterior a la transición. Los campos de fecha u hora no válidos en la sobrecarga numérica provocan una DateTimeException.
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) es un método de fábrica estático. En un solapamiento usa el desfase preferido solo si es uno de los dos válidos. Si recibe null o un desfase que no coincide, selecciona la primera aparición. Si hay un único desfase válido o hay un hueco, se comporta como of. Una preferencia no valida la entrada: si la aplicación debe rechazar los huecos o exigir una elección explícita en los solapamientos, consulta zone.getRules().getValidOffsets(localDateTime), que devuelve 0, 1 o 2 desfases.
ZonedDateTime.withZoneSameInstant(zone) muestra el mismo evento en otra zona: toInstant() da un valor igual aunque cambien la fecha o la hora locales. No hay que resolver huecos ni solapamientos locales; un resultado fuera del intervalo de fechas admitido provoca una DateTimeException. ZonedDateTime.withZoneSameLocal(zone) interpreta la misma fecha y hora como locales de la zona de destino, por lo que el instante puede cambiar. Sigue las reglas de ofLocal y usa el desfase actual como preferencia. En un hueco no puede conservar la fecha y hora locales originales. Ninguno de los dos métodos modifica el objeto original.
Ejemplos
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
public class ZonedDateTimeTransform {
public static void main(String[] args) {
ZoneId paris = ZoneId.of("Europe/Paris");
LocalDateTime wallTime = LocalDateTime.of(2024, 10, 27, 2, 30);
ZonedDateTime defaultChoice = ZonedDateTime.of(wallTime, paris);
ZonedDateTime earlier = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(2));
ZonedDateTime later = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(1));
System.out.println("of: " + defaultChoice);
System.out.println("ofLocal +02:00: " + earlier + " -> " + earlier.toInstant());
System.out.println("ofLocal +01:00: " + later + " -> " + later.toInstant());
System.out.println("same instant: " + earlier.withZoneSameInstant(ZoneOffset.UTC));
System.out.println("same local: " + earlier.withZoneSameLocal(ZoneOffset.UTC));
}
}Resultado
of: 2024-10-27T02:30+02:00[Europe/Paris] ofLocal +02:00: 2024-10-27T02:30+02:00[Europe/Paris] -> 2024-10-27T00:30:00Z ofLocal +01:00: 2024-10-27T02:30+01:00[Europe/Paris] -> 2024-10-27T01:30:00Z same instant: 2024-10-27T00:30Z same local: 2024-10-27T02:30Z
Con las reglas de `Europe/Paris` del ejemplo, `02:30` aparece dos veces: `+02:00` da `00:30Z` y `+01:00` da `01:30Z`. `of` elige la primera aparición; las dos llamadas a `ofLocal` seleccionan ambos desfases de forma explícita. Al pasar la primera aparición a UTC se obtiene `00:30Z` si se conserva el instante, o `02:30Z` si se conserva la lectura del reloj. Los resultados de una zona regional dependen de las reglas disponibles en el entorno de ejecución.
Lecciones relacionadas
- Java · Lección 60 · Avanzado · Versión: 2