Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti