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.