WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen