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

CKTIS / Java

LocalDate.of — crear una fecha a partir del año, el mes y el día

Crea una fecha ISO a partir de tres campos, elige la sobrecarga adecuada y compara fechas por valor con `equals`, no por referencia con `==`.

Versión: Java SE 21

Sintaxis

public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)

LocalDate.of es un método de fábrica estático de java.time.LocalDate. Recibe el año, el mes y el día del mes, en ese orden. Devuelve una fecha inmutable del calendario ISO-8601, sin hora ni zona horaria. A diferencia de LocalDate.now(), no consulta el reloj.

El segundo argumento es un int de 1 (enero) a 12 (diciembre) o una constante de la enumeración java.time.Month, como Month.JANUARY. El año debe estar entre -999999999 y 999999999, ambos incluidos. El día debe estar entre 1 y 31 y existir en el mes y el año indicados. Un campo fuera de rango o una fecha inexistente, como el 29 de febrero de 2019, provoca una DateTimeException; el método no ajusta la fecha. Pasar null como Month provoca una NullPointerException.

LocalDate es una clase basada en valores. Dos llamadas para 2020-01-01 dan fechas iguales según equals, pero no se garantiza que devuelvan objetos distintos. == compara referencias, no fechas. No uses instancias de LocalDate para la sincronización.

Ejemplos

import java.time.DateTimeException;
import java.time.LocalDate;
import java.time.Month;

public class Main {
    public static void main(String[] args) {
        final int year = 2020;
        LocalDate january = LocalDate.of(year, 1, 1);
        LocalDate sameJanuary = LocalDate.of(year, Month.JANUARY, 1);
        LocalDate june = LocalDate.of(year, Month.JUNE, 1);
        LocalDate july = LocalDate.of(year, 7, 1);
        LocalDate previousDecember = LocalDate.of(year - 1, Month.DECEMBER, 31);

        System.out.println(january);
        System.out.println(june);
        System.out.println(july);
        System.out.println(previousDecember);
        System.out.println(january.equals(sameJanuary));

        try {
            LocalDate.of(year - 1, Month.FEBRUARY, 29);
        } catch (DateTimeException e) {
            System.out.println("DateTimeException");
        }
    }
}

Resultado

2020-01-01
2020-06-01
2020-07-01
2019-12-31
true
DateTimeException

El programa imprime fechas fijas de enero, junio y julio de 2020 y una fecha de diciembre del año anterior, calculado con `year - 1`. Ambas sobrecargas producen la misma fecha de enero, así que `equals` devuelve `true`. Como 2019 no es bisiesto, el bloque `catch` imprime `DateTimeException`.

Lecciones relacionadas

  • Java · Lección 4 · Avanzado · Versión: 2
  • Java · Lección 11 · Avanzado · Versión: 2

Fuentes