Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Tworzenie i przesuwanie lokalnej daty i czasu

Utwórz lokalną datę i czas za pomocą `LocalDateTime.of`, a następnie dodaj godziny lub minuty bez zmiany wartości początkowej.

Wersja: Java SE 21

Składnia

import java.time.LocalDateTime;

LocalDateTime start = LocalDateTime.of(year, month, dayOfMonth, hour, minute);
LocalDateTime later = start.plusHours(hours).plusMinutes(minutes);

// Factory arguments shown: int. Amounts passed to plusHours and plusMinutes: long.

java.time.LocalDateTime łączy datę kalendarzową z godziną widoczną na zegarze. Nie przechowuje strefy czasowej ani przesunięcia względem UTC i sam nie wyznacza konkretnej chwili na osi czasu. Obliczenia nie uwzględniają zmiany czasu letniego i zimowego.

Statyczna metoda LocalDateTime.of(year, month, dayOfMonth, hour, minute) przyjmuje w pokazanej wersji pięć argumentów typu int, w tym miesiąc od 1 do 12. Ustawia pola sekund i nanosekund na zero. Inne przeciążenia pozwalają podać liczbę sekund i opcjonalnie nanosekund, użyć stałej Month zamiast numeru miesiąca lub połączyć LocalDate z LocalTime. W wersjach przyjmujących pola nieprawidłowa data lub wartość poza zakresem powoduje DateTimeException.

Metody instancji plusHours(long hours) i plusMinutes(long minutes) dodają odpowiednio godziny i minuty. Ujemny argument cofa datę i czas, a przekroczenie północy zmienia również datę. Wynik poza obsługiwanym zakresem dat powoduje DateTimeException.

LocalDateTime jest niemutowalny: metody zwracają wynik, nie zmieniając obiektu, na którym je wywołano. Zapisz zwróconą wartość lub użyj jej od razu w kolejnym wywołaniu, tak jak w start.plusHours(1).plusMinutes(20).

Przykłady

import java.time.LocalDateTime;

public class LocalDateTimeDemo {
    public static void main(String[] args) {
        LocalDateTime start = LocalDateTime.of(2026, 4, 30, 22, 50);
        LocalDateTime afterHours = start.plusHours(1);
        LocalDateTime afterMinutes = afterHours.plusMinutes(20);

        System.out.println(start);
        System.out.println(afterHours);
        System.out.println(afterMinutes);
        System.out.println(start);
    }
}

Wynik

2026-04-30T22:50
2026-04-30T23:50
2026-05-01T00:10
2026-04-30T22:50

Dodanie godziny daje 23:50, a kolejne 20 minut przesuwa wynik na 1 maja, 00:10. Ostatni wiersz powtarza datę i czas początkowy. Zapis rozdziela datę od czasu literą `T` i pomija zerowe pola sekund i nanosekund.

Powiązane lekcje

  • Java · Lekcja 68 · Podstawowy · Wersja: 2

Źródła