CKTIS / Java
Construir un LocalDateTime y hallar el lunes de una semana ISO
Crea fechas y horas locales a partir de datos fijos, calcula el lunes de la misma semana ISO y elige la sobrecarga que devuelve el tipo que necesitas.
Versión: Java SE 21
Sintaxis
Java SE 21 — java.time
Static factories:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute, int second)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
The same three component overloads accept Month instead of int for month.
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
Instance methods on a LocalDate named date:
LocalDate date.with(TemporalAdjuster adjuster)
LocalDate date.with(TemporalField field, long newValue)
LocalDateTime date.atTime(int hour, int minute)
LocalDateTime date.atTime(int hour, int minute, int second)
LocalDateTime date.atTime(int hour, int minute, int second, int nanoOfSecond)
LocalDateTime date.atTime(LocalTime time)
OffsetDateTime date.atTime(OffsetTime time)
Common composition: date.with(DayOfWeek.MONDAY).atTime(9, 30)En java.time, el método de fábrica estático LocalDate.of crea una fecha ISO a partir del año, el mes y el día del mes. Indica el mes con un número del 1 al 12 o un valor de Month, como Month.MARCH. El método de fábrica estático LocalDateTime.of recibe los mismos componentes de fecha más la hora y el minuto; otras sobrecargas admiten también los segundos y después los nanosegundos. Los segundos y nanosegundos omitidos valen cero. Otra sobrecarga combina un LocalDate y un LocalTime existentes.
El método de instancia LocalDate.with no modifica la fecha original: utiliza el valor devuelto. En date.with(DayOfWeek.MONDAY), el valor de la enumeración actúa como TemporalAdjuster y selecciona el lunes de la misma semana ISO (de lunes a domingo), con independencia de la configuración regional. Si la fecha ya es lunes, su valor no cambia; si no, el resultado es anterior y puede caer en otro mes o año. La sobrecarga with(TemporalField, long) asigna un valor numérico a un campo. Para ChronoField.DAY_OF_WEEK, 1 también selecciona el lunes de la misma semana ISO.
El método de instancia LocalDate.atTime combina la fecha con un LocalTime o con los componentes de la hora: hora y minuto, seguidos opcionalmente por segundos y luego nanosegundos. Los componentes omitidos valen cero. Con un LocalTime, date.atTime(time) da el mismo valor que LocalDateTime.of(date, time). En cambio, la sobrecarga con OffsetTime devuelve un OffsetDateTime y conserva el desfase respecto de UTC.
Los métodos of lanzan DateTimeException si la fecha no es válida. Las sobrecargas que reciben componentes horarios numéricos lanzan esa excepción si algún componente queda fuera de rango, por ejemplo, si la hora es 24. LocalDate y LocalDateTime son inmutables. Un LocalDateTime no contiene zona horaria ni desfase respecto de UTC, por lo que no identifica por sí solo un instante.
Ejemplos
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.Month;
public class Main {
public static void main(String[] args) {
LocalDate date = LocalDate.of(2024, Month.MARCH, 1);
LocalDate monday = date.with(DayOfWeek.MONDAY);
LocalDateTime adjusted = monday.atTime(9, 30);
LocalDateTime direct = LocalDateTime.of(2024, 2, 26, 9, 30);
LocalDateTime combined = LocalDateTime.of(monday, LocalTime.of(9, 30));
System.out.println(date);
System.out.println(adjusted);
System.out.println(adjusted.equals(direct) && adjusted.equals(combined));
}
}Resultado
2024-03-01 2024-02-26T09:30 true
La entrada es el viernes `2024-03-01`. El lunes correspondiente, `2024-02-26`, cae en el mes anterior. Al añadir la hora `09:30`, las tres formas dan valores `LocalDateTime` iguales, como indica `true`.
Lecciones relacionadas
- Java · Lección 60 · Avanzado · Versión: 2