Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Duration — czas trwania i różnica między chwilami

java.time.Duration opisuje ilość czasu w sekundach i nanosekundach. Duration.between oblicza różnicę między zgodnymi obiektami czasowymi; wynik może być dodatni, zerowy lub ujemny.

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

Składnia

Duration.between(Temporal startInclusive, Temporal endExclusive)

java.time.Duration jest niemutowalną, bezpieczną wątkowo ilością czasu, a nie datą ani chwilą. Przechowuje sekundy i część nanosekundową. W przeciwieństwie do kalendarzowego Period dzień w Duration oznacza zawsze 24 godziny, bez uwzględniania zmian czasu letniego.

Duration.between(startInclusive, endExclusive) oblicza różnicę od początku włącznie do końca wyłącznie. Argumenty muszą obsługiwać SECONDS; pełna precyzja wymaga również NANOS lub NANO_OF_SECOND. Jeśli argumenty mają różne typy, typ pierwszego decyduje o tym, jak interpretowany jest drugi. Gdy początkiem jest LocalDateTime, końcem może być OffsetDateTime: jego przesunięcie względem UTC jest pomijane. W odwrotnej kolejności wywołanie zgłasza DateTimeException, ponieważ LocalDateTime nie zawiera przesunięcia względem UTC. Niezgodne obiekty mogą spowodować DateTimeException, a przepełnienie — ArithmeticException.

Przykład używa stałych wartości Instant, więc nie zależy od zegara ani domyślnej strefy czasowej. Wynik PT1H30M45S oznacza 1 godzinę, 30 minut i 45 sekund. toMinutes() zwraca łączną liczbę pełnych minut, czyli 90, a nie składnik minutowy 30. W tym przykładzie zamiana kolejności argumentów daje ujemny czas trwania.

Przykłady

import java.time.Duration;
import java.time.Instant;

public class Main {
    public static void main(String[] args) {
        Instant start = Instant.parse("2025-01-01T10:00:00Z");
        Instant end = Instant.parse("2025-01-01T11:30:45Z");
        Duration elapsed = Duration.between(start, end);

        System.out.println(elapsed);
        System.out.println(elapsed.toMinutes());
        System.out.println(Duration.between(end, start).isNegative());
    }
}

Wynik

PT1H30M45S
90
true

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

Źródła