Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Raščlamba, stvaranje i oblikovanje datuma i datuma s vremenom u Javi

Stvarajte datume iz pojedinačnih polja, raščlanjujte tekst u zapisu ISO ili po vlastitom uzorku te oblikujte datume s vremenom ili bez njega, bez dodjele vremenske zone.

Verzija: Java SE 21

Sintaksa

Java SE 21 — java.time.LocalDate and java.time.LocalDateTime; formatter type: java.time.format.DateTimeFormatter

Static factory and parsing methods:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDate LocalDate.parse(CharSequence text)
LocalDate LocalDate.parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.of also accepts java.time.Month instead of an int month. Both component-based forms have overloads with a trailing int second or with trailing int second, int nanoOfSecond.

Instance methods:
String date.format(DateTimeFormatter formatter) // date: LocalDate
String date.toString() // date: LocalDate
String dateTime.format(DateTimeFormatter formatter) // dateTime: LocalDateTime

U paketu java.time tip LocalDate predstavlja samo datum ISO, dok LocalDateTime spaja datum ISO s lokalnim vremenom. Nijedan tip ne pohranjuje vremensku zonu ili pomak u odnosu na UTC i sam po sebi ne određuje jedinstven trenutak. Oba su tipa nepromjenjiva.

LocalDate.of(year, month, dayOfMonth) statička je tvornička metoda koja prihvaća broj mjeseca od 1 do 12 ili konstantu Month. Statička tvornička metoda LocalDateTime.of(date, time) spaja LocalDate i LocalTime. Preopterećene inačice s pojedinačnim poljima prihvaćaju broj mjeseca ili Month, zahtijevaju sat i minutu te omogućuju dodavanje sekunde i zatim nanosekunde. Izostavljena sekunda ili nanosekunda ima vrijednost nula. Nevaljane vrijednosti polja, poput 29. veljače u godini koja nije prijestupna, izazivaju DateTimeException.

Statička metoda LocalDate.parse(text) koristi DateTimeFormatter.ISO_LOCAL_DATE, primjerice za 2024-02-29. Preopterećena inačica LocalDate.parse(text, formatter) koristi predani formater, primjerice s uzorkom dd/MM/uuuu. Ako se tekst ne može raščlaniti u datum, baca se DateTimeParseException. DateTimeFormatter.ofPattern zadano koristi SMART, koji 29/02/2023 može prilagoditi na 28. veljače. Za odbijanje takvih datuma postavite ResolverStyle.STRICT i koristite uuuu (godina), a ne yyyy (godina ere).

Metode instance LocalDate.format(formatter) i LocalDateTime.format(formatter) vraćaju String pomoću predanog formatera bez promjene vrijednosti. Ako nedostaje potrebno polje, primjerice sat za HH:mm pri oblikovanju LocalDate, oblikovanje baca DateTimeException. LocalDate.toString() ne prima formater i vraća tekst ISO-8601, primjerice 2024-02-29. U uzorcima je bitna veličina slova: MM označava mjesec, mm minutu, a HH sat u 24-satnom zapisu.

Primjeri

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
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) {
        DateTimeFormatter dateFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);
        DateTimeFormatter dateTimeFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu HH:mm", Locale.ROOT);

        LocalDate date = LocalDate.of(2024, 2, 29);
        LocalDate fromIso = LocalDate.parse("2024-02-29");
        LocalDate fromCustom = LocalDate.parse("29/02/2024", dateFormat);

        System.out.println(date.equals(fromIso) && date.equals(fromCustom));
        System.out.println(date.toString());
        System.out.println(date.format(dateFormat));

        LocalDateTime dateTime = LocalDateTime.of(date, LocalTime.of(9, 5));
        System.out.println(dateTime.format(dateTimeFormat));

        try {
            LocalDate.parse("29/02/2023", dateFormat);
            System.out.println("Unexpected success");
        } catch (DateTimeParseException e) {
            System.out.println("Invalid date rejected");
        }
    }
}

Rezultat

true
2024-02-29
29/02/2024
29/02/2024 09:05
Invalid date rejected

Prvi redak potvrđuje da su obje raščlanjene vrijednosti jednake datumu iz tvorničke metode. Sljedeća tri prikazuju datum ISO, datum u vlastitom formatu i datum s vremenom. Posljednji pokazuje da stroga raščlamba odbija 29. veljače 2023.

Povezane lekcije

  • Java · Lekcija 61 · Napredno · Verzija: 2

Izvori