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.ResolverStyleIl 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