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.