Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.ResolverStyle

Statič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

Izvori