Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła