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.ResolverStyleStatická 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