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.