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

CKTIS / Java

DateTimeFormatter: vzory, miestne nastavenia a striktné parsovanie

Vzorom a miestnymi nastaveniami urči podobu textu a režimom vyhodnotenia pravidlá kontroly dátumu. Rozlišuj `MM` a `mm` aj `uuuu` a `yyyy`.

Verzia: Java SE 21

Syntax

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

Statická metóda DateTimeFormatter.ofPattern vytvára formátovač podľa vzoru. Preťaženie ofPattern(String) používa predvolené miestne nastavenia kategórie FORMAT, kým ofPattern(String, Locale) použije zadané nastavenia. Obe začínajú v režime SMART. Neplatný vzor vyvolá IllegalArgumentException už pri vytváraní formátovača.

Vo vzore záleží na veľkosti písmen: dd je deň v mesiaci, MM je číslo mesiaca a mm sú minúty. dd-MM-uuuu, dd/MM/uuuu a uuuu-MM-dd určujú poradie polí a oddeľovače. uuuu je proleptický rok (zahŕňa rok nula), zatiaľ čo yyyy je rok v ére. Pri striktnom parsovaní ISO nestačí yyyy spolu s mesiacom a dňom na vytvorenie LocalDate, pretože sa nepredpokladá žiadna éra. Pre dátumy bez éry používaj uuuu.

DateTimeFormatter.withLocale nastaví Locale vráteného formátovača. Ovplyvní text, napríklad celé názvy mesiacov (MMMM), pri formátovaní aj parsovaní, ale nezmení poradie polí ani oddeľovače v explicitnom vzore. Formátovače sú nemenné a možno ich bezpečne zdieľať medzi vláknami: uchovaj výsledok withLocale alebo withResolverStyle, pretože pôvodný objekt sa nemení.

DateTimeFormatter.withResolverStyle riadi druhú fázu parsovania: po načítaní polí podľa vzoru z nich formátovač zostaví dátum. Formátovanie sa nemení. Pri dátumoch ISO režim STRICT odmieta neexistujúce dátumy, SMART môže upraviť deň v rozsahu 1–31 na posledný deň mesiaca a LENIENT môže preniesť prebytočné dni do ďalšieho mesiaca. LocalDate.parse(text, formatter) vyvolá DateTimeParseException, ak text nezodpovedá vzoru alebo z neho nemožno vytvoriť dátum.

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

Výsledok

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

Miestne nastavenia zmenia názov mesiaca, nie štruktúru dátumu. Názvy závisia od lokalizačných údajov prostredia, v ktorom kód beží. Pre `31-02-2024` vráti `SMART` hodnotu `2024-02-29`, zatiaľ čo `STRICT` vstup odmietne.

Súvisiace lekcie

  • Java · Lekcia 61 · Pokročilá · Verzia: 2

Zdroje