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