Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

LocalDateTime — data i czas bez strefy czasowej

LocalDateTime przechowuje datę i czas w kalendarzu ISO bez strefy czasowej ani przesunięcia UTC. Pozwala tworzyć wartości, dodawać godziny i minuty oraz formatować wynik, nie zmieniając pierwotnej wartości.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.plusHours(long hours)
LocalDateTime.plusMinutes(long minutes)
LocalDateTime.format(DateTimeFormatter formatter)

java.time.LocalDateTime reprezentuje datę i czas bez strefy czasowej ani przesunięcia UTC. Sam nie określa jednoznacznego momentu na osi czasu. Nie używaj go do obliczania rzeczywistego czasu trwania przez zmianę czasu letniego; do tego potrzebny jest kontekst strefy lub momenty typu Instant.

LocalDateTime.of(year, month, dayOfMonth, hour, minute) tworzy wartość z sekundami i nanosekundami równymi zero. Miesiące mają numery 1–12. Niepoprawna data, np. 30 lutego, powoduje DateTimeException.

LocalDateTime.plusHours(long) i LocalDateTime.plusMinutes(long) zwracają wynik bez zmiany oryginału, więc trzeba go zachować. Przyjmują także liczby ujemne. Przejście przez północ aktualizuje datę; przekroczenie obsługiwanego zakresu powoduje DateTimeException.

LocalDateTime.format(DateTimeFormatter) zwraca String. We wzorcu uuuu-MM-dd HH:mm symbole MM oznaczają miesiąc, mm minuty, a HH godzinę w zapisie 24-godzinnym. Przykład używa stałych danych i Locale.ROOT, pokazując przejście do następnego roku oraz niezmienność start.

Przykłady

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        LocalDateTime start = LocalDateTime.of(2024, 12, 31, 23, 30);
        LocalDateTime end = start.plusHours(1).plusMinutes(45);
        DateTimeFormatter formatter =
                DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm", Locale.ROOT);

        System.out.println(start.format(formatter));
        System.out.println(end.format(formatter));
    }
}

Wynik

2024-12-31 23:30
2025-01-01 01:15

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła