CKTIS / Java
Duration — verstrichene Zeit und Unterschiede zwischen Zeitpunkten
java.time.Duration stellt eine Zeitspanne in Sekunden und Nanosekunden dar. Duration.between berechnet den Unterschied zwischen kompatiblen Zeitobjekten; das Ergebnis kann positiv, null oder negativ sein.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Duration.between(Temporal startInclusive, Temporal endExclusive)java.time.Duration ist eine unveränderliche, threadsichere Zeitspanne und weder ein Datum noch ein Zeitpunkt. Sie speichert Sekunden und einen in Nanosekunden angegebenen Sekundenbruchteil. Anders als beim kalenderbasierten Period bedeutet ein Tag in Duration immer 24 Stunden, ohne Änderungen durch die Sommerzeit zu berücksichtigen.
Duration.between(startInclusive, endExclusive) berechnet die Zeitdifferenz vom Start (einschließlich) bis zum Ende (ausschließlich). Die Argumente müssen SECONDS unterstützen; für volle Präzision ist außerdem NANOS oder NANO_OF_SECOND erforderlich. Haben die Argumente unterschiedliche Typen, bestimmt der Typ des ersten Arguments, wie das zweite interpretiert wird. Ist der Start ein LocalDateTime, kann das Ende ein OffsetDateTime sein; dessen UTC-Offset wird ignoriert. In umgekehrter Reihenfolge löst der Aufruf eine DateTimeException aus, weil LocalDateTime keinen UTC-Offset hat. Nicht kompatible Objekte können eine DateTimeException auslösen, ein Überlauf eine ArithmeticException.
Das Beispiel verwendet feste Instant-Werte und hängt daher weder von der Uhr noch von der Standardzeitzone ab. Das Ergebnis PT1H30M45S bedeutet 1 Stunde, 30 Minuten und 45 Sekunden. toMinutes() gibt die Gesamtzahl ganzer Minuten zurück, also 90, nicht den Minutenanteil 30. In diesem Beispiel ergibt das Vertauschen der Argumente eine negative Zeitspanne.
Beispiele
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());
}
}Ergebnis
PT1H30M45S 90 true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.