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.