WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

TimeUnit — Zeiteinheiten und Umrechnungen

TimeUnit beschreibt Zeiteinheiten, die etwa bei Zeitlimits verwendet werden. Damit lassen sich long-Werte umrechnen; Nachkommanteile werden abgeschnitten und Überläufe durch Begrenzung abgefangen.

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

Syntax

TimeUnit.MILLISECONDS.toNanos(long duration)
TimeUnit.NANOSECONDS.convert(long sourceDuration, TimeUnit sourceUnit)

java.util.concurrent.TimeUnit ist ein Enum, das Zeiteinheiten beschreibt und unter anderem bei Vorgängen mit Zeitlimit verwendet wird. Es speichert und misst selbst keine Zeit.

TimeUnit.MILLISECONDS steht für Millisekunden. Die Instanzmethode TimeUnit.toNanos(long duration) interpretiert das Argument in der Einheit des Empfängers: TimeUnit.MILLISECONDS.toNanos(2L) gibt 2000000L zurück. Der gleichwertige Aufruf lautet TimeUnit.NANOSECONDS.convert(2L, TimeUnit.MILLISECONDS) — der Empfänger von convert legt die Zieleinheit fest.

Bei der Umrechnung in eine größere Einheit wird der Nachkommateil verworfen: 999 Millisekunden ergeben 0 Sekunden. Bei einem Überlauf wird das Ergebnis auf Long.MIN_VALUE oder Long.MAX_VALUE begrenzt, statt umzuschlagen.

Eine Nanosekundeneinheit garantiert keine Zeitmessgenauigkeit im Nanosekundenbereich. Das Beispiel führt nur deterministische Umrechnungen aus und wartet nicht.

Beispiele

import java.util.concurrent.TimeUnit;

public class Main {
    public static void main(String[] args) {
        System.out.println(TimeUnit.MILLISECONDS.toNanos(2L));
        System.out.println(TimeUnit.MILLISECONDS.toSeconds(999L));
        System.out.println(TimeUnit.MILLISECONDS.toNanos(Long.MAX_VALUE));
    }
}

Ergebnis

2000000
0
9223372036854775807

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