Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

DateTimeFormatter: pattern, impostazioni locali e parsing rigoroso

Scegli un pattern e le impostazioni locali per il testo, poi uno stile di risoluzione per convalidare la data. Distingui `MM` da `mm` e `uuuu` da `yyyy`.

Versione: Java SE 21

Sintassi

java.time.format.DateTimeFormatter (Java SE 21)
static DateTimeFormatter ofPattern(String pattern)
static DateTimeFormatter ofPattern(String pattern, Locale locale)
DateTimeFormatter withLocale(Locale locale)
DateTimeFormatter withResolverStyle(ResolverStyle resolverStyle)

Locale: java.util.Locale
ResolverStyle: java.time.format.ResolverStyle

Il metodo statico DateTimeFormatter.ofPattern crea un formattatore a partire da un pattern. L’overload ofPattern(String) usa le impostazioni locali predefinite della categoria FORMAT; ofPattern(String, Locale) usa quelle specificate. Entrambi partono da SMART. Un pattern non valido causa una IllegalArgumentException alla creazione del formattatore.

Maiuscole e minuscole contano: dd è il giorno del mese, MM il mese numerico e mm indica i minuti. dd-MM-uuuu, dd/MM/uuuu e uuuu-MM-dd stabiliscono l’ordine dei campi e i separatori. uuuu indica l’anno prolettico (comprende l’anno zero), mentre yyyy indica l’anno dell’era. Nel parsing ISO rigoroso, yyyy con solo mese e giorno non basta per ottenere un LocalDate, perché non viene presupposta alcuna era. Usa uuuu per date senza era.

DateTimeFormatter.withLocale imposta la Locale del formattatore restituito. Influisce sul testo, ad esempio sui nomi completi dei mesi (MMMM), sia in formattazione sia in parsing, ma non cambia l’ordine dei campi né i separatori di un pattern esplicito. I formattatori sono immutabili e thread-safe: conserva il risultato di withLocale o withResolverStyle, perché l’originale non cambia.

DateTimeFormatter.withResolverStyle controlla la seconda fase del parsing: letti i campi secondo il pattern, il formattatore li combina in una data. La formattazione non cambia. Per le date ISO, STRICT rifiuta le date impossibili, SMART può ricondurre un giorno tra 1 e 31 all’ultimo del mese e LENIENT può riportare i giorni in eccesso al mese successivo. LocalDate.parse(text, formatter) lancia DateTimeParseException se il testo non corrisponde al pattern o non consente di ottenere una data.

Esempi

import java.time.LocalDate;
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) {
        LocalDate date = LocalDate.of(2024, 1, 5);
        DateTimeFormatter english = DateTimeFormatter.ofPattern("dd MMMM uuuu", Locale.US);
        DateTimeFormatter french = english.withLocale(Locale.FRANCE);
        System.out.println(date.format(english));
        System.out.println(date.format(french));

        DateTimeFormatter smart = DateTimeFormatter.ofPattern("dd-MM-uuuu", Locale.ROOT);
        DateTimeFormatter strict = smart.withResolverStyle(ResolverStyle.STRICT);
        String invalid = "31-02-2024";
        System.out.println("SMART: " + LocalDate.parse(invalid, smart));
        try {
            System.out.println("STRICT: " + LocalDate.parse(invalid, strict));
        } catch (DateTimeParseException e) {
            System.out.println("STRICT: rejected");
        }
    }
}

Risultato

05 January 2024
05 janvier 2024
SMART: 2024-02-29
STRICT: rejected

Le impostazioni locali cambiano il nome del mese, non la struttura della data. I nomi dipendono dai dati di localizzazione dell’ambiente di esecuzione. Con `31-02-2024`, `SMART` restituisce `2024-02-29`, mentre `STRICT` rifiuta l’input.

Lezioni correlate

  • Java · Lezione 61 · Avanzato · Versione: 2

Fonti