CKTIS / Java
Crear y desplazar una fecha y hora locales
Crea una fecha y hora locales con `LocalDateTime.of` y suma horas o minutos sin cambiar el valor original.
Versión: Java SE 21
Sintaxis
import java.time.LocalDateTime;
LocalDateTime start = LocalDateTime.of(year, month, dayOfMonth, hour, minute);
LocalDateTime later = start.plusHours(hours).plusMinutes(minutes);
// Factory arguments shown: int. Amounts passed to plusHours and plusMinutes: long.java.time.LocalDateTime combina una fecha del calendario con una hora tal como se lee en un reloj. No almacena ni una zona horaria ni un desfase respecto de UTC, por lo que no identifica por sí solo un instante. Sus cálculos no tienen en cuenta los cambios de horario de verano.
En la forma mostrada, el método estático de fábrica LocalDateTime.of(year, month, dayOfMonth, hour, minute) recibe cinco argumentos de tipo int, con meses numerados del 1 al 12. Inicializa a cero los campos de segundos y nanosegundos. Otras sobrecargas permiten indicar los segundos y, opcionalmente, los nanosegundos, usar una constante Month en lugar del número de mes o combinar un LocalDate y un LocalTime. En las sobrecargas que reciben campos individuales, una fecha no válida o un campo fuera de rango provoca una DateTimeException.
Los métodos de instancia plusHours(long hours) y plusMinutes(long minutes) suman horas y minutos, respectivamente. Una cantidad negativa hace retroceder el valor, y cruzar la medianoche también cambia la fecha. Si el resultado queda fuera del intervalo de fechas admitido, se lanza una DateTimeException.
LocalDateTime es inmutable: los métodos devuelven el resultado sin modificar el objeto sobre el que se invocaron. Guarda el valor devuelto o úsalo directamente en la siguiente llamada, como en start.plusHours(1).plusMinutes(20).
Ejemplos
import java.time.LocalDateTime;
public class LocalDateTimeDemo {
public static void main(String[] args) {
LocalDateTime start = LocalDateTime.of(2026, 4, 30, 22, 50);
LocalDateTime afterHours = start.plusHours(1);
LocalDateTime afterMinutes = afterHours.plusMinutes(20);
System.out.println(start);
System.out.println(afterHours);
System.out.println(afterMinutes);
System.out.println(start);
}
}Resultado
2026-04-30T22:50 2026-04-30T23:50 2026-05-01T00:10 2026-04-30T22:50
Al sumar una hora se obtienen las 23:50, y al sumar otros 20 minutos se llega al 1 de mayo a las 00:10. La última línea repite la fecha y hora originales. La salida separa la fecha y la hora con `T` y omite los campos de segundos y nanosegundos porque valen cero.
Lecciones relacionadas
- Java · Lección 68 · Básico · Versión: 2