CKTIS / Java
ZonedDateTime: creación, conversión, formato y ajustes de calendario
Crea fechas y horas con zona horaria, conviértelas sin cambiar el instante, aplica un formato y modifica campos locales teniendo en cuenta los cambios de hora.
Versión: Java SE 21
Sintaxis
java.time.ZonedDateTime — Java SE 21
static ZonedDateTime of(LocalDateTime dateTime, ZoneId zone)
static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
static ZonedDateTime ofInstant(Instant instant, ZoneId zone)
static ZonedDateTime ofInstant(LocalDateTime dateTime, ZoneOffset offset, ZoneId zone)
Instant toInstant() // inherited from ChronoZonedDateTime
ZonedDateTime withZoneSameInstant(ZoneId zone)
String format(DateTimeFormatter formatter)
ZonedDateTime with(TemporalAdjuster adjuster)
ZonedDateTime with(TemporalField field, long newValue)
ZonedDateTime withHour(int hour)
ZonedDateTime withMinute(int minute)java.time.ZonedDateTime guarda una fecha y hora locales, un identificador de zona y el desplazamiento respecto a UTC determinado para ese valor. El método estático ZonedDateTime.of admite un LocalDateTime, un par LocalDate y LocalTime o siete enteros (de year a nanoOfSecond), siempre con un ZoneId. Si al adelantar el reloj se omite un intervalo, desplaza la fecha y hora locales hacia delante la duración de ese intervalo. Si la hora local se repite, elige el desplazamiento que corresponde al primer instante. Los campos numéricos inválidos o una fecha imposible provocan DateTimeException.
ZonedDateTime.ofInstant(Instant, ZoneId) obtiene la fecha, la hora y el desplazamiento del instante en la zona de destino. La sobrecarga (LocalDateTime, ZoneOffset, ZoneId) determina primero el instante a partir de la fecha y hora locales y el desplazamiento proporcionados, y después lo representa en la zona de destino. Tanto la hora local como el desplazamiento pueden diferir de la entrada. El método heredado ZonedDateTime.toInstant() devuelve el mismo instante sin información de zona. ZonedDateTime.withZoneSameInstant(ZoneId) conserva el instante, pero puede cambiar la fecha y hora locales. En cambio, withZoneSameLocal intenta conservar la fecha y hora locales y puede cambiar el instante.
ZonedDateTime.format(DateTimeFormatter) devuelve un String sin modificar el objeto. ISO_OFFSET_DATE_TIME muestra la fecha y hora locales y el desplazamiento, pero no el identificador de zona regional. Si falla el formateo, el método lanza DateTimeException.
ZonedDateTime.with(TemporalAdjuster) aplica una regla, como TemporalAdjusters.lastDayOfMonth(). La sobrecarga with(TemporalField, long) establece un campo admitido, como ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS fija el segundo en la línea temporal y conserva la zona y la fracción de segundo. OFFSET_SECONDS solo puede seleccionar el otro desplazamiento válido si la hora local se repite. Un campo no admitido puede provocar UnsupportedTemporalTypeException; un valor no válido puede provocar DateTimeException.
ZonedDateTime.withHour(int) fija la hora (0–23) y ZonedDateTime.withMinute(int) el minuto (0–59); estos métodos no suman tiempo transcurrido. Un valor fuera de rango provoca DateTimeException. Al cambiar campos locales, la zona se mantiene, pero el instante puede cambiar. Si el resultado cae en un intervalo omitido, se adelanta la duración de ese intervalo. Si la hora se repite, se conserva el desplazamiento anterior si sigue siendo válido; si no, se elige el primer instante. Los objetos son inmutables, así que guarda el valor devuelto.
Ejemplos
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoField;
import java.time.temporal.TemporalAdjusters;
public class Main {
public static void main(String[] args) {
ZoneOffset east = ZoneOffset.of("+01:00");
ZoneOffset west = ZoneOffset.of("-05:00");
DateTimeFormatter iso = DateTimeFormatter.ISO_OFFSET_DATE_TIME;
ZonedDateTime original = ZonedDateTime.of(
LocalDateTime.of(2024, 1, 15, 10, 30), east);
Instant instant = original.toInstant();
ZonedDateTime converted = original.withZoneSameInstant(west);
ZonedDateTime rebuilt = ZonedDateTime.ofInstant(instant, west);
ZonedDateTime edited = original.with(ChronoField.MONTH_OF_YEAR, 2)
.with(TemporalAdjusters.lastDayOfMonth())
.withHour(14)
.withMinute(45);
System.out.println(original.format(iso));
System.out.println(instant);
System.out.println(converted.format(iso));
System.out.println(converted.equals(rebuilt));
System.out.println(edited.format(iso));
}
}Resultado
2024-01-15T10:30:00+01:00 2024-01-15T09:30:00Z 2024-01-15T04:30:00-05:00 true 2024-02-29T14:45:00+01:00
Las tres primeras líneas representan el mismo instante. `true` muestra que ambas conversiones a `-05:00` coinciden. La última línea muestra el ajuste al 29 de febrero a las 14:45 con el desplazamiento original. Los desplazamientos fijos hacen que el ejemplo no dependa de las reglas de las zonas regionales.
Lecciones relacionadas
- Java · Lección 59 · Intermedio · Versión: 2