WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Duration-Werte erzeugen, addieren und umrechnen

Erzeuge eine Dauer aus einer Minutenanzahl oder zwei Zeitpunkten, addiere eine weitere Dauer und lies die Gesamtzahl der Minuten oder Stunden ab.

Version: Java SE 21

Syntax

import java.time.Duration;
import java.time.temporal.Temporal;
import java.time.temporal.TemporalUnit;

// Static methods declared by Duration
public static Duration between(Temporal startInclusive, Temporal endExclusive)
public static Duration ofMinutes(long minutes)

// Instance methods declared by Duration
public Duration plus(Duration duration)
public Duration plus(long amountToAdd, TemporalUnit unit)
public long toHours()
public long toMinutes()

In Java SE 21 steht java.time.Duration für eine unveränderliche Dauer mit Vorzeichen, nicht für ein Datum oder eine Uhrzeit. Die statische Fabrikmethode Duration.ofMinutes(long minutes) erzeugt eine Dauer aus einer Minutenanzahl, die auch negativ sein kann. Eine Minute hat genau 60 Sekunden.

Die statische Methode Duration.between(start, end) berechnet die Differenz vom eingeschlossenen Anfang bis zum ausgeschlossenen Ende. Liegt das Ende vor dem Anfang, ist das Ergebnis negativ. Beide Argumente müssen die Einheit SECONDS unterstützen. Bei unterschiedlichen Typen richtet sich die Berechnung nach dem Typ des ersten Arguments. Lässt sich die Differenz in Sekunden nicht ermitteln, löst die Methode eine DateTimeException aus.

Für zwei Duration-Werte gibt a.plus(b) die Summe zurück, ohne einen der beiden Werte zu ändern. Speichere den Rückgabewert, wenn du die Summe weiterverwenden willst. Die Überladung plus(long, TemporalUnit) nimmt eine Anzahl und eine Einheit mit exakter Länge entgegen, etwa ChronoUnit.MINUTES. Die Ausnahme ist ChronoUnit.DAYS: Ein Tag zählt als 24 Stunden. Nicht unterstützte Einheiten führen zu einer UnsupportedTemporalTypeException. Liegt das Ergebnis außerhalb des Wertebereichs von Duration, lösen ofMinutes, between und beide plus-Überladungen eine ArithmeticException aus.

toMinutes() und toHours() geben Gesamtzahlen als long zurück, keine Minuten- oder Stundenanteile. Sie teilen die gespeicherten Sekunden durch 60 beziehungsweise 3600, ganzzahlig in Richtung null und ohne Berücksichtigung des Nanosekundenfelds. Bei 95 Minuten ergeben sich 95 beziehungsweise 1; toMinutesPart() liefert dagegen 35.

Beispiele

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

public class Main {
    public static void main(String[] args) {
        Instant start = Instant.parse("2025-01-01T09:00:00Z");
        Instant end = Instant.parse("2025-01-01T10:15:00Z");
        Duration elapsed = Duration.between(start, end);
        Duration extra = Duration.ofMinutes(20);
        Duration total = elapsed.plus(extra);

        System.out.println("elapsed.toMinutes() = " + elapsed.toMinutes());
        System.out.println("total.toMinutes() = " + total.toMinutes());
        System.out.println("total.toHours() = " + total.toHours());
    }
}

Ergebnis

elapsed.toMinutes() = 75
total.toMinutes() = 95
total.toHours() = 1

Zwischen den festen Zeitpunkten liegen 75 Minuten. Mit weiteren 20 Minuten ergibt das 95 Minuten, also 1 volle Stunde. `elapsed` steht weiterhin für 75 Minuten.

Zugehörige Lektionen

  • Java · Lektion 68 · Grundlagen · Version: 2

Quellen