Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes