CKTIS / Java
LocalDate: creare, spostare, confrontare e visualizzare date
Crea una data del calendario ISO, spostala di un certo numero di giorni senza modificare l’originale, confrontala con un’altra data e ottienila come testo.
Versione: Java SE 21
Sintassi
import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;
// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()java.time.LocalDate rappresenta una data del calendario ISO senza ora né fuso orario. Il metodo factory statico LocalDate.of riceve, nell’ordine, l’anno, il mese e il giorno del mese. Il mese può essere un int da 1 a 12 oppure un valore Month non null, come Month.FEBRUARY. Una data non valida, come il 29 febbraio di un anno non bisestile, genera una DateTimeException anziché essere corretta.
date.plusDays(n) accetta un numero di giorni di calendario di tipo long e restituisce la data risultante, cambiando mese o anno se necessario. Un valore negativo sposta la data indietro; zero ne conserva il valore. LocalDate è immutabile: la chiamata non modifica date, quindi salva o usa il valore restituito. Se il calcolo non va in overflow ma la data risultante è fuori dall’intervallo supportato, il metodo genera una DateTimeException, come in LocalDate.MAX.plusDays(1). In JDK 21, se la somma intermedia al numero di giorni dall’epoca supera i limiti del tipo long, il metodo genera una ArithmeticException prima di verificare l’intervallo di date.
a.isAfter(b) restituisce true solo se a è successiva a b. Se a è precedente o entrambe indicano lo stesso giorno, restituisce false. Il parametro è di tipo ChronoLocalDate e b non può essere null. Il confronto considera la posizione delle date sulla linea temporale locale, senza tener conto dei rispettivi sistemi di calendario.
date.toString() restituisce una String nel formato ISO-8601 uuuu-MM-dd, per esempio 2024-03-01. Non stampa nulla e non adatta il testo alle impostazioni locali. Per un formato destinato al lettore, usa format con un DateTimeFormatter adatto.
Esempi
import java.time.LocalDate;
public class Main {
public static void main(String[] args) {
LocalDate start = LocalDate.of(2024, 2, 28);
LocalDate later = start.plusDays(2);
System.out.println(start.toString());
System.out.println(later.toString());
System.out.println(later.isAfter(start));
System.out.println(later.isAfter(later));
}
}Risultato
2024-02-28 2024-03-01 true false
Il 2024 è bisestile, quindi due giorni dopo `2024-02-28` si arriva a `2024-03-01`. La prima riga mostra che la data di partenza è invariata; le ultime due mostrano che il risultato è successivo alla data di partenza, ma non a sé stesso.
Lezioni correlate
- Java · Lezione 68 · Base · Versione: 2