KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

TimeUnit — tijdseenheden en conversies

TimeUnit beschrijft tijdseenheden die onder meer bij time-outs worden gebruikt. Hiermee kun je long-waarden omrekenen, waarbij fracties worden afgekapt of overloop wordt begrensd.

Versie: 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 is een enum die tijdseenheden beschrijft en onder meer wordt gebruikt bij bewerkingen met een time-out. De enum slaat zelf geen tijd op en meet die ook niet.

TimeUnit.MILLISECONDS staat voor milliseconden. De instantiemethode TimeUnit.toNanos(long duration) interpreteert het argument in de eenheid van de ontvanger: TimeUnit.MILLISECONDS.toNanos(2L) geeft 2000000L terug. De equivalente aanroep is TimeUnit.NANOSECONDS.convert(2L, TimeUnit.MILLISECONDS) — de ontvanger van convert bepaalt de doeleenheid.

Bij een conversie naar een grotere eenheid wordt het fractionele deel weggelaten: 999 milliseconden wordt 0 seconden. Bij overloop wordt het resultaat begrensd op Long.MIN_VALUE of Long.MAX_VALUE, in plaats van terug te lopen.

Een eenheid in nanoseconden garandeert geen timingnauwkeurigheid op nanosecondenniveau. Het voorbeeld voert alleen deterministische conversies uit, zonder te wachten.

Voorbeelden

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));
    }
}

Resultaat

2000000
0
9223372036854775807

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen