CKTIS / Java
LocalDate — una data senza ora né fuso orario
LocalDate rappresenta una data immutabile del calendario ISO, senza ora né fuso orario. Consente di creare, spostare, confrontare, analizzare e formattare le date.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
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 memorizza una data del calendario ISO senza ora né fuso orario; da solo non identifica un istante sulla linea temporale. È immutabile e thread-safe. LocalDate.of(year, month, dayOfMonth) crea una data; i mesi sono numerati da 1 a 12. Una data non valida causa DateTimeException.
LocalDate.plusDays restituisce il risultato dell’aggiunta di giorni, tenendo conto dei confini dei mesi e degli anni bisestili; l’oggetto originale rimane invariato. LocalDate.with(adjuster) applica una regola di correzione, mentre LocalDate.with(field, newValue) imposta un campo. La gestione di un giorno non valido dipende dal campo: cambiare il mese può limitare il giorno alla fine del mese, ma un DAY_OF_MONTH non valido causa un’eccezione.
LocalDate.isAfter verifica se una data è successiva. LocalDate.equals confronta i valori delle date di tipo LocalDate, non l’identità degli oggetti: non sostituirlo con ==. Per due oggetti LocalDate, LocalDate.compareTo restituisce un numero negativo, zero o positivo in base all’ordine delle date; non presumere che il risultato sia esattamente -1 o 1.
LocalDate.parse(text) legge una data ISO; la versione con formatter supporta un altro formato. Un errore di analisi causa DateTimeParseException. LocalDate.toString restituisce testo ISO, mentre LocalDate.format(formatter) usa il formatter fornito. Nel modello dd/MM/uuuu, uuuu indica l’anno, non l’anno dell’era (yyyy).
LocalDate.atTime(hour, minute) crea un LocalDateTime, ancora senza fuso orario; la versione con OffsetTime restituisce OffsetDateTime. L’esempio usa date fisse e mostra il 29 febbraio 2024. Ambito della documentazione: Java SE 21; l’ambiente di produzione non è attestato.
Esempi
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));
}
}Risultato
2024-02-28 2024-02-29 true true true 2024-02-29 2024-02-29T09:30 29/02/2024
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.