Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

ResolverStyle — striktné zostavovanie dátumu z polí

ResolverStyle určuje, ako sa z načítaných polí zostaví dátum alebo čas. Správanie ResolverStyle.STRICT závisí od polí: pri zostavovaní kalendárneho dátumu ISO z roka, mesiaca a dňa tento štýl odmietne 29. február v nepriestupnom roku.

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

Syntax

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

ResolverStyle je výčtový typ v java.time.format. Pri parsovaní sa najprv načítajú hodnoty polí z textu. V druhej fáze sa z týchto hodnôt zostaví dátum alebo čas. Štýl riadi túto druhú fázu, nie počiatočné porovnávanie textu so vzorom ani formátovanie výstupu.

Pri zostavovaní kalendárneho dátumu ISO z roka, mesiaca a dňa ResolverStyle.STRICT vyžaduje, aby deň existoval v danom mesiaci a roku. Pri rovnakých poliach môže ResolverStyle.SMART nahradiť príliš vysoké číslo dňa posledným dňom mesiaca, zatiaľ čo ResolverStyle.LENIENT umožňuje prenášať prebytok medzi poľami. Pravidlá závisia od toho, ktoré polia sa kombinujú. Napríklad v Java SE 21 môžu lokalizované polia WeekFields pri zostavovaní dátumu z týždenných údajov previesť 53. týždeň na 52. týždeň, ak má rok podľa týždenného číslovania iba 52 týždňov, a to aj v režime STRICT.

Nastav štýl pomocou withResolverStyle(ResolverStyle.STRICT) a ďalej používaj vrátený formatter: metóda pôvodný formatter nemení. Formatter vytvorený pomocou ofPattern štandardne používa SMART. Pre vzor dátumu bez éry použi uuuu-MM-dd: uuuu označuje rok, zatiaľ čo yyyy označuje rok v rámci éry. Ak éra nie je uvedená, rok v rámci éry nemusí pri striktnom zostavovaní dátumu stačiť na vytvorenie LocalDate.

Príklad prijme 2024-02-29, ale pre 2023-02-29 zachytí DateTimeParseException. Vypíše pevnú správu namiesto textu výnimky závislého od implementácie. Rozsah dokumentácie: Java SE 21; behové prostredia repozitára a produkcie neboli potvrdené.

Príklady

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

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje