Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ResolverStyle — risoluzione rigorosa delle date

ResolverStyle controlla come i campi analizzati vengono combinati per formare una data o un orario. Il comportamento di ResolverStyle.STRICT dipende dai campi: per una data del calendario ISO espressa come anno, mese e giorno, rifiuta il 29 febbraio di un anno non bisestile.

Versione: Java SE 21 (documentation scope); repository and production runtimes not attested

Sintassi

DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

ResolverStyle è un tipo enum di java.time.format. L’analisi legge prima i campi dal testo e poi li combina in una data o un orario. Lo stile controlla questa seconda fase, non la corrispondenza iniziale del testo con un pattern né la formattazione dell’output.

Quando risolve una data del calendario ISO a partire da anno, mese e giorno, ResolverStyle.STRICT richiede che il giorno esista nel mese e nell’anno indicati. Per gli stessi campi, ResolverStyle.SMART può sostituire un numero del giorno troppo alto con l’ultimo giorno del mese, mentre ResolverStyle.LENIENT consente di trasferire l’eccedenza da un campo all’altro. Le regole dipendono dai campi da risolvere. Ad esempio, in Java SE 21, durante la risoluzione di una data espressa in settimane, i campi localizzati di WeekFields possono ricondurre la settimana 53 alla 52 in un anno basato sulle settimane che ne conta solo 52, anche in modalità STRICT.

Imposta lo stile con withResolverStyle(ResolverStyle.STRICT) e conserva il formatter restituito: il metodo non modifica l’originale. Un formatter creato con ofPattern usa SMART per impostazione predefinita. Per un pattern di data senza era, usa uuuu-MM-dd: uuuu indica l’anno, mentre yyyy indica l’anno dell’era, che potrebbe non bastare a creare un LocalDate con risoluzione rigorosa senza era.

L’esempio accetta 2024-02-29, ma intercetta DateTimeParseException per 2023-02-29. Stampa un messaggio fisso invece di un testo dell’eccezione dipendente dall’implementazione. Ambito della documentazione: Java SE 21; gli ambienti di esecuzione del repository e di produzione non sono stati attestati.

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) {
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        for (String text : new String[] {"2024-02-29", "2023-02-29"}) {
            try {
                System.out.println(LocalDate.parse(text, formatter));
            } catch (DateTimeParseException ex) {
                System.out.println("Rejected: " + text);
            }
        }
    }
}

Risultato

2024-02-29
Rejected: 2023-02-29

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