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

CKTIS / Java

LocalDate — una fecha sin hora ni zona horaria

LocalDate representa una fecha inmutable del calendario ISO, sin hora ni zona horaria. Permite crear, desplazar, comparar, analizar y dar formato a fechas.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

LocalDate.of(year, month, dayOfMonth)
date.plusDays(days)
date.isAfter(other)
date.toString()
date.equals(other)
date.compareTo(other)
date.with(adjuster)
date.with(field, newValue)
date.atTime(hour, minute)
LocalDate.parse(text)
LocalDate.parse(text, formatter)
date.format(formatter)

java.time.LocalDate almacena una fecha del calendario ISO sin hora ni zona horaria; por sí sola, no identifica un instante en la línea temporal. Es inmutable y segura para usar entre hilos. LocalDate.of(year, month, dayOfMonth) crea una fecha; los meses se numeran del 1 al 12. Una fecha no válida provoca DateTimeException.

LocalDate.plusDays devuelve el resultado de sumar días, teniendo en cuenta los límites de los meses y los años bisiestos; el objeto original no cambia. LocalDate.with(adjuster) aplica una regla de ajuste, mientras que LocalDate.with(field, newValue) establece un campo. El tratamiento de un día no válido depende del campo: cambiar el mes puede limitar el día al final del mes, pero un DAY_OF_MONTH no válido provoca una excepción.

LocalDate.isAfter comprueba si una fecha es posterior. LocalDate.equals compara valores de fecha de tipo LocalDate, no la identidad de los objetos; no lo sustituyas por ==. Para dos objetos LocalDate, LocalDate.compareTo devuelve un número negativo, cero o un número positivo según el orden de las fechas; no des por hecho que el resultado sea exactamente -1 o 1.

LocalDate.parse(text) lee una fecha ISO; la sobrecarga con formatter admite otro formato. Un error de análisis provoca DateTimeParseException. LocalDate.toString devuelve texto ISO, mientras que LocalDate.format(formatter) usa el formatter indicado. En el patrón dd/MM/uuuu, uuuu significa año, no año de era (yyyy).

LocalDate.atTime(hour, minute) crea un LocalDateTime, todavía sin zona horaria; la sobrecarga con OffsetTime devuelve OffsetDateTime. El ejemplo usa fechas fijas y muestra el 29 de febrero de 2024. Alcance de la documentación: Java SE 21; el entorno de producción no está acreditado.

Ejemplos

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate next = start.plusDays(1);
        LocalDate parsed = LocalDate.parse("2024-02-29");
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");

        System.out.println(start.toString());
        System.out.println(next.toString());
        System.out.println(next.isAfter(start));
        System.out.println(next.equals(parsed));
        System.out.println(start.compareTo(next) < 0);
        System.out.println(start.with(TemporalAdjusters.lastDayOfMonth()));
        System.out.println(next.atTime(9, 30));
        System.out.println(next.format(formatter));
    }
}

Resultado

2024-02-28
2024-02-29
true
true
true
2024-02-29
2024-02-29T09:30
29/02/2024

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes