CKTIS / Java
TimeUnit — jednostki czasu i konwersje
TimeUnit opisuje jednostki czasu używane m.in. w limitach oczekiwania. Pozwala przeliczać wartości long, z utratą części ułamkowej lub nasyceniem przy przepełnieniu.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
TimeUnit.MILLISECONDS.toNanos(long duration)
TimeUnit.NANOSECONDS.convert(long sourceDuration, TimeUnit sourceUnit)java.util.concurrent.TimeUnit to typ wyliczeniowy opisujący jednostki czasu, używany m.in. w operacjach z limitem oczekiwania. Sam nie przechowuje czasu ani go nie mierzy.
TimeUnit.MILLISECONDS oznacza milisekundy. Metoda instancyjna TimeUnit.toNanos(long duration) interpretuje argument w jednostce odbiorcy: TimeUnit.MILLISECONDS.toNanos(2L) zwraca 2000000L. Równoważne wywołanie to TimeUnit.NANOSECONDS.convert(2L, TimeUnit.MILLISECONDS) — odbiorca convert określa jednostkę docelową.
Konwersja do większej jednostki odrzuca część ułamkową: 999 milisekund daje 0 sekund. Przy przepełnieniu wynik jest ograniczany do Long.MIN_VALUE lub Long.MAX_VALUE, zamiast zawijać się.
Jednostka nanosekundowa nie gwarantuje nanosekundowej dokładności oczekiwania. Przykład wykonuje wyłącznie deterministyczne konwersje, bez oczekiwania.
Przykłady
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));
}
}Wynik
2000000 0 9223372036854775807
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.