Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

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

Viri