CKTIS / Java
DateTimeFormatter: obrasci, regionalne postavke i strogo parsiranje
Obrascem i regionalnim postavkama odredi izgled teksta, a načinom razrješavanja pravila provjere datuma. Razlikuj `MM` od `mm` i `uuuu` od `yyyy`.
Verzija: 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čka metoda DateTimeFormatter.ofPattern stvara objekt za formatiranje prema obrascu. Varijanta ofPattern(String) koristi zadane regionalne postavke kategorije FORMAT, a ofPattern(String, Locale) koristi izričito zadane postavke. Obje počinju s načinom SMART. Nevaljani obrazac uzrokuje IllegalArgumentException pri stvaranju objekta.
Velika i mala slova u obrascu imaju različita značenja: dd je dan u mjesecu, MM je broj mjeseca, a mm označava minute. dd-MM-uuuu, dd/MM/uuuu i uuuu-MM-dd određuju redoslijed polja i razdjelnike. uuuu je proleptička godina (uključuje godinu nula), a yyyy godina unutar ere. Pri strogom parsiranju ISO datuma yyyy, mjesec i dan nisu dovoljni za LocalDate jer se ne pretpostavlja nijedna era. Za datume bez ere koristi uuuu.
DateTimeFormatter.withLocale postavlja Locale objekta koji vraća. To utječe na tekst poput punih naziva mjeseci (MMMM) pri formatiranju i parsiranju, ali ne mijenja redoslijed polja ni razdjelnike u izričito zadanom obrascu. Objekti za formatiranje nepromjenjivi su i sigurni za dijeljenje među dretvama: zadrži rezultat withLocale ili withResolverStyle jer se izvorni objekt ne mijenja.
DateTimeFormatter.withResolverStyle upravlja drugom fazom parsiranja: nakon čitanja polja prema obrascu objekt ih sastavlja u datum. Ne mijenja formatiranje. Za ISO datume STRICT odbija nemoguće datume, SMART može svesti dan u rasponu 1–31 na zadnji dan mjeseca, a LENIENT može prenijeti višak dana u sljedeći mjesec. LocalDate.parse(text, formatter) baca DateTimeParseException ako tekst ne odgovara obrascu ili se iz njega ne može dobiti datum.
Primjeri
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
Promjena regionalnih postavki mijenja naziv mjeseca, ali ne i raspored datuma. Nazivi ovise o lokalizacijskim podacima izvršnog okruženja. Za `31-02-2024` način `SMART` vraća `2024-02-29`, dok `STRICT` odbija unos.
Povezane lekcije
- Java · Lekcija 61 · Napredno · Verzija: 2