KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ResolverStyle — strikte datumresolutie

ResolverStyle bepaalt hoe geparseerde velden worden samengevoegd tot een datum of tijd. Het gedrag van ResolverStyle.STRICT hangt af van de velden: bij een ISO-kalenderdatum met jaar, maand en dag wijst deze stijl 29 februari in een niet-schrikkeljaar af.

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

Syntax

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

ResolverStyle is een enum in java.time.format. Bij het parsen worden eerst velden uit de tekst gelezen en daarna samengevoegd tot een datum of tijd. De stijl bepaalt die tweede fase, niet de eerste overeenkomst tussen tekst en patroon of de opmaak van de uitvoer.

Bij het samenstellen van een ISO-kalenderdatum uit jaar, maand en dag vereist ResolverStyle.STRICT dat de dag in de opgegeven maand en het opgegeven jaar bestaat. Voor diezelfde velden kan ResolverStyle.SMART een te hoog dagnummer vervangen door de laatste dag van de maand, terwijl ResolverStyle.LENIENT toestaat dat het overschot van het ene veld wordt overgedragen naar een ander veld. De regels hangen af van de velden die worden samengevoegd. Zo kunnen in Java SE 21 de regioafhankelijke velden van WeekFields bij het samenstellen van een weekdatum week 53 terugbrengen tot week 52 als het weekjaar maar 52 weken telt, zelfs in de modus STRICT.

Stel de stijl in met withResolverStyle(ResolverStyle.STRICT) en gebruik de geretourneerde formatter verder: de methode wijzigt het origineel niet. Een formatter die met ofPattern is gemaakt, gebruikt standaard SMART. Gebruik voor een datumpatroon zonder era uuuu-MM-dd: uuuu betekent jaar, terwijl yyyy het jaar binnen een era betekent. Dat kan bij strikte resolutie zonder era onvoldoende zijn om een LocalDate te maken.

Het voorbeeld accepteert 2024-02-29, maar vangt voor 2023-02-29 een DateTimeParseException op. Het drukt een vaste melding af in plaats van implementatieafhankelijke uitzonderingstekst. Documentatiebereik: Java SE 21; de runtimeomgevingen van de repository en productie zijn niet bevestigd.

Voorbeelden

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);
            }
        }
    }
}

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen