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.