Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

DateTimeFormatter — formattazione e analisi delle date

DateTimeFormatter converte date e orari in testo e analizza il testo. Scopri i pattern, la selezione esplicita di Locale, la convalida rigorosa e le differenze tra MM e mm e tra uuuu e yyyy.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm").withLocale(Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

DateTimeFormatter è immutabile e thread-safe. DateTimeFormatter.ofPattern crea un formatter a partire da un pattern; puoi riutilizzarlo per formattare e analizzare date.

Per MM e mm: MM indica il mese a due cifre, mentre mm indica i minuti a due cifre. Per uuuu e yyyy: uuuu indica l’anno prolettico, mentre yyyy indica l’anno dell’era. Per analizzare rigorosamente date ISO senza era, usa uuuu; yyyy da solo non basta a risolvere la data.

DateTimeFormatter.withLocale restituisce un formatter con il Locale selezionato, che influisce, per esempio, sui nomi dei mesi. Anche DateTimeFormatter.withResolverStyle lascia invariato l’oggetto originale. Scegli ResolverStyle.STRICT per rifiutare le date non valide. La modalità predefinita di ofPattern, SMART, può correggere il giorno portandolo alla fine del mese, per esempio da 2023-02-29 a 2023-02-28.

L’esempio accetta 2024-02-29 09:07, ma rifiuta 2023-02-29 09:07. STRICT controlla la risoluzione dei campi durante l’analisi, non la formattazione.

Esempi

import java.time.LocalDateTime;
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 formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd HH:mm")
                .withLocale(Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        LocalDateTime value = LocalDateTime.parse("2024-02-29 09:07", formatter);
        System.out.println(value.format(formatter));

        try {
            LocalDateTime.parse("2023-02-29 09:07", formatter);
            throw new AssertionError("Expected rejection");
        } catch (DateTimeParseException ex) {
            System.out.println("Invalid date rejected");
        }
    }
}

Risultato

2024-02-29 09:07
Invalid date rejected

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