CKTIS / Java
DateTimeFormatter: vzorci, jezikovne nastavitve in strogo razčlenjevanje
Z vzorcem in jezikovnimi nastavitvami določi zapis, z načinom razreševanja pa pravila preverjanja datuma. Razlikuj med `MM` in `mm` ter med `uuuu` in `yyyy`.
Različica: Java SE 21
Sintaksa
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.ResolverStyleStatična metoda DateTimeFormatter.ofPattern ustvari oblikovalnik iz vzorca. Različica ofPattern(String) uporablja privzete jezikovne nastavitve kategorije FORMAT, različica ofPattern(String, Locale) pa izrecno podane nastavitve. Obe privzeto uporabljata SMART. Neveljaven vzorec že ob ustvarjanju oblikovalnika sproži IllegalArgumentException.
Velike in male črke v vzorcu se razlikujejo: dd je dan v mesecu, MM je številka meseca, mm pa pomeni minute. dd-MM-uuuu, dd/MM/uuuu in uuuu-MM-dd določajo vrstni red polj in ločila. uuuu je proleptično leto (vključuje leto nič), yyyy pa leto znotraj ere. Pri strogem razčlenjevanju datumov ISO yyyy skupaj z mesecem in dnevom ne zadošča za LocalDate, ker se nobena era ne privzame. Za datume brez ere uporabi uuuu.
DateTimeFormatter.withLocale nastavi Locale vrnjenega oblikovalnika. Vpliva na besedilo, na primer na polna imena mesecev (MMMM), tako pri oblikovanju kot pri razčlenjevanju. Ne spremeni vrstnega reda polj ali ločil v izrecno podanem vzorcu. Oblikovalniki so nespremenljivi in varni za uporabo v več nitih: shrani rezultat withLocale ali withResolverStyle, ker se izvirnik ne spremeni.
DateTimeFormatter.withResolverStyle določa drugo fazo razčlenjevanja: po branju polj v skladu z vzorcem jih oblikovalnik sestavi v datum. Na oblikovanje ne vpliva. Pri datumih ISO STRICT zavrne nemogoče datume, SMART lahko dan iz razpona 1–31 omeji na zadnji dan meseca, LENIENT pa lahko odvečne dni prenese v naslednji mesec. LocalDate.parse(text, formatter) sproži DateTimeParseException, če besedilo ne ustreza vzorcu ali iz njega ni mogoče sestaviti datuma.
Primeri
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");
}
}
}
Rezultat
05 January 2024 05 janvier 2024 SMART: 2024-02-29 STRICT: rejected
Sprememba jezikovnih nastavitev spremeni ime meseca, ne pa zgradbe datuma. Imena so odvisna od lokalizacijskih podatkov izvajalnega okolja. Za `31-02-2024` način `SMART` vrne `2024-02-29`, `STRICT` pa vnos zavrne.
Povezane lekcije
- Java · Lekcija 61 · Napredna · Različica: 2