Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

LocalDate.of — creare una data da anno, mese e giorno

Crea una data ISO da tre campi, scegli l’overload adatto ai dati di partenza e confronta le date per valore con `equals`, non per riferimento con `==`.

Versione: Java SE 21

Sintassi

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

LocalDate.of è un metodo factory statico di java.time.LocalDate. Accetta anno, mese e giorno del mese, in quest’ordine. Restituisce una data immutabile del calendario ISO-8601, senza ora né fuso orario. A differenza di LocalDate.now(), non consulta l’orologio.

Il secondo argomento è un int da 1 (gennaio) a 12 (dicembre) oppure una costante dell’enumerazione java.time.Month, come Month.JANUARY. L’anno deve essere compreso tra -999999999 e 999999999, estremi inclusi. Il giorno deve essere compreso tra 1 e 31 ed esistere nel mese e nell’anno indicati. Un campo fuori intervallo o una data inesistente, come il 29 febbraio 2019, provoca una DateTimeException; il metodo non corregge la data. Passare null come Month provoca una NullPointerException.

LocalDate è una classe basata sui valori. Due chiamate per 2020-01-01 producono date uguali secondo equals, ma non è garantito che restituiscano oggetti distinti. == confronta i riferimenti, non le date. Non usare istanze di LocalDate per la sincronizzazione.

Esempi

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");
        }
    }
}

Risultato

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

Il programma stampa date fisse di gennaio, giugno e luglio 2020 e una data di dicembre dell’anno precedente, calcolato con `year - 1`. Entrambi gli overload producono la stessa data di gennaio, quindi `equals` restituisce `true`. Poiché il 2019 non è bisestile, il blocco `catch` stampa `DateTimeException`.

Lezioni correlate

  • Java · Lezione 4 · Avanzato · Versione: 2
  • Java · Lezione 11 · Avanzato · Versione: 2

Fonti