Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Analizzare, creare e formattare date e date con ora in Java

Crea date dai singoli campi, analizza testo ISO o con un pattern personalizzato e formatta date e orari senza assegnare un fuso orario.

Versione: Java SE 21

Sintassi

Java SE 21 — java.time.LocalDate and java.time.LocalDateTime; formatter type: java.time.format.DateTimeFormatter

Static factory and parsing methods:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDate LocalDate.parse(CharSequence text)
LocalDate LocalDate.parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.of also accepts java.time.Month instead of an int month. Both component-based forms have overloads with a trailing int second or with trailing int second, int nanoOfSecond.

Instance methods:
String date.format(DateTimeFormatter formatter) // date: LocalDate
String date.toString() // date: LocalDate
String dateTime.format(DateTimeFormatter formatter) // dateTime: LocalDateTime

In java.time, LocalDate rappresenta solo una data ISO, mentre LocalDateTime combina una data ISO con un orario locale. Nessuno dei due memorizza un fuso orario o uno scostamento da UTC, né identifica da solo un istante univoco. Entrambi i tipi sono immutabili.

LocalDate.of(year, month, dayOfMonth) è un metodo factory statico che accetta il mese come numero da 1 a 12 o come costante Month. Il metodo factory statico LocalDateTime.of(date, time) combina un LocalDate con un LocalTime. Gli overload che ricevono i singoli campi accettano il mese come numero o Month, richiedono ora e minuto e consentono di aggiungere il secondo e poi il nanosecondo. Un secondo o un nanosecondo omesso vale zero. Campi non validi, come il 29 febbraio in un anno non bisestile, generano una DateTimeException.

Il metodo statico LocalDate.parse(text) usa DateTimeFormatter.ISO_LOCAL_DATE, per esempio per 2024-02-29. L’overload LocalDate.parse(text, formatter) usa il formattatore fornito, per esempio con il pattern dd/MM/uuuu. Se il testo non può essere interpretato come data, viene lanciata una DateTimeParseException. Per impostazione predefinita, DateTimeFormatter.ofPattern usa SMART, che può correggere 29/02/2023 al 28 febbraio. Per rifiutare date simili, imposta ResolverStyle.STRICT e usa uuuu (anno), non yyyy (anno dell’era).

I metodi di istanza LocalDate.format(formatter) e LocalDateTime.format(formatter) restituiscono una String usando il formattatore fornito senza modificare il valore. Se manca un campo richiesto, per esempio l’ora necessaria a HH:mm su un LocalDate, la formattazione genera una DateTimeException. LocalDate.toString() non accetta un formattatore e restituisce testo ISO-8601, come 2024-02-29. Nei pattern le maiuscole contano: MM indica il mese, mm il minuto e HH l’ora in formato 24 ore.

Esempi

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        DateTimeFormatter dateFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);
        DateTimeFormatter dateTimeFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu HH:mm", Locale.ROOT);

        LocalDate date = LocalDate.of(2024, 2, 29);
        LocalDate fromIso = LocalDate.parse("2024-02-29");
        LocalDate fromCustom = LocalDate.parse("29/02/2024", dateFormat);

        System.out.println(date.equals(fromIso) && date.equals(fromCustom));
        System.out.println(date.toString());
        System.out.println(date.format(dateFormat));

        LocalDateTime dateTime = LocalDateTime.of(date, LocalTime.of(9, 5));
        System.out.println(dateTime.format(dateTimeFormat));

        try {
            LocalDate.parse("29/02/2023", dateFormat);
            System.out.println("Unexpected success");
        } catch (DateTimeParseException e) {
            System.out.println("Invalid date rejected");
        }
    }
}

Risultato

true
2024-02-29
29/02/2024
29/02/2024 09:05
Invalid date rejected

La prima riga conferma che entrambi i valori analizzati coincidono con la data creata dal metodo factory. Le tre successive mostrano la data ISO, la data nel formato personalizzato e la data con ora. L’ultima mostra che il parsing rigoroso rifiuta il 29 febbraio 2023.

Lezioni correlate

  • Java · Lezione 61 · Avanzato · Versione: 2

Fonti