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

CKTIS / Java

LocalDate: crear, desplazar, comparar y mostrar fechas

Crea una fecha del calendario ISO, desplázala por días naturales sin modificar el original, compárala con otra fecha y obtén su representación textual.

Versión: Java SE 21

Sintaxis

import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;

// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()

java.time.LocalDate representa una fecha del calendario ISO sin hora ni zona horaria. El método de fábrica estático LocalDate.of recibe, en ese orden, el año, el mes y el día del mes. El mes puede ser un int de 1 a 12 o un valor Month no nulo, como Month.FEBRUARY. Una fecha no válida, como el 29 de febrero de un año no bisiesto, lanza una DateTimeException en vez de ajustarse.

date.plusDays(n) recibe un número de días naturales de tipo long y devuelve la fecha resultante, cambiando de mes o de año si hace falta. Un valor negativo retrocede la fecha; cero conserva su valor. LocalDate es inmutable: la llamada no modifica date, así que guarda o utiliza el resultado. Si el cálculo no se desborda pero la fecha resultante queda fuera del intervalo admitido, el método lanza una DateTimeException, como en LocalDate.MAX.plusDays(1). En JDK 21, si la suma intermedia al número de días desde la época desborda el tipo long, el método lanza una ArithmeticException antes de comprobar el intervalo de fechas.

a.isAfter(b) devuelve true solo si a es posterior a b. Si a es anterior o ambas representan el mismo día, devuelve false. El parámetro es de tipo ChronoLocalDate y b no puede ser null. Se compara la posición de las fechas en la línea temporal local, sin tener en cuenta sus sistemas de calendario.

date.toString() devuelve un String en formato ISO-8601 uuuu-MM-dd, como 2024-03-01. No imprime nada ni adapta el texto a la configuración regional. Para un formato pensado para el lector, usa format con un DateTimeFormatter adecuado.

Ejemplos

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate later = start.plusDays(2);

        System.out.println(start.toString());
        System.out.println(later.toString());
        System.out.println(later.isAfter(start));
        System.out.println(later.isAfter(later));
    }
}

Resultado

2024-02-28
2024-03-01
true
false

2024 es bisiesto, así que dos días después de `2024-02-28` es `2024-03-01`. La primera línea muestra que la fecha inicial no cambia; las dos últimas muestran que el resultado es posterior a la fecha inicial, pero no a sí mismo.

Lecciones relacionadas

  • Java · Lección 68 · Básico · Versión: 2

Fuentes