Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Parsowanie, tworzenie i formatowanie dat oraz dat z czasem w Javie

Twórz daty z pól, odczytuj tekst w formacie ISO lub według własnego wzorca i formatuj daty oraz daty z czasem bez przypisywania im strefy czasowej.

Wersja: Java SE 21

Składnia

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

W pakiecie java.time typ LocalDate reprezentuje samą datę ISO, a LocalDateTime łączy datę ISO z lokalnym czasem. Żaden z tych typów nie przechowuje strefy czasowej ani przesunięcia względem UTC i sam nie wskazuje jednoznacznego momentu. Oba typy są niemutowalne.

LocalDate.of(year, month, dayOfMonth) to statyczna metoda fabryczna przyjmująca miesiąc jako liczbę od 1 do 12 lub stałą typu Month. Statyczna metoda LocalDateTime.of(date, time) łączy LocalDate i LocalTime; przeciążenia przyjmujące pola przyjmują miesiąc jako liczbę lub Month, wymagają godziny i minuty oraz pozwalają podać sekundę, a po niej nanosekundę. Pominięta sekunda lub nanosekunda ma wartość zero. Nieprawidłowe wartości pól, np. 29 lutego w roku nieprzestępnym, powodują DateTimeException.

Statyczna metoda LocalDate.parse(text) używa DateTimeFormatter.ISO_LOCAL_DATE, np. dla 2024-02-29. Przeciążenie LocalDate.parse(text, formatter) używa przekazanego formatera, np. ze wzorcem dd/MM/uuuu. Tekst, którego nie da się przetworzyć na datę, powoduje DateTimeParseException. DateTimeFormatter.ofPattern domyślnie używa SMART, który może zmienić 29/02/2023 na 28 lutego. Aby odrzucać takie daty, ustaw ResolverStyle.STRICT i użyj uuuu (rok), a nie yyyy (rok ery).

Metody instancji LocalDate.format(formatter) i LocalDateTime.format(formatter) zwracają String zgodny z przekazanym formaterem, nie zmieniając wartości. Jeśli wymagane pole jest niedostępne, np. godzina w LocalDate dla HH:mm, formatowanie kończy się wyjątkiem DateTimeException. Metoda LocalDate.toString() nie przyjmuje formatera i zwraca zapis ISO-8601, np. 2024-02-29. Wzorce rozróżniają wielkość liter: MM oznacza miesiąc, mm minutę, a HH godzinę w zapisie 24-godzinnym.

Przykłady

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");
        }
    }
}

Wynik

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

Pierwszy wiersz potwierdza, że oba odczyty dają tę samą datę co metoda fabryczna. Kolejne trzy pokazują zapis ISO, własny zapis daty i zapis daty z czasem. Ostatni pokazuje odrzucenie 29 lutego 2023 r. w trybie ścisłym.

Powiązane lekcje

  • Java · Lekcja 61 · Zaawansowany · Wersja: 2

Źródła