Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

TimeUnit — časové jednotky a převody

TimeUnit popisuje časové jednotky používané mimo jiné u operací s časovým limitem. Umožňuje převádět hodnoty long, přičemž zlomkové části ořezává a při přetečení výsledek saturuje.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

TimeUnit.MILLISECONDS.toNanos(long duration)
TimeUnit.NANOSECONDS.convert(long sourceDuration, TimeUnit sourceUnit)

java.util.concurrent.TimeUnit je výčtový typ popisující časové jednotky, který se používá mimo jiné u operací s časovým limitem. Sám čas neukládá ani neměří.

TimeUnit.MILLISECONDS označuje milisekundy. Instanční metoda TimeUnit.toNanos(long duration) interpretuje argument v jednotce příjemce: TimeUnit.MILLISECONDS.toNanos(2L) vrátí 2000000L. Ekvivalentní volání je TimeUnit.NANOSECONDS.convert(2L, TimeUnit.MILLISECONDS) — příjemce metody convert určuje cílovou jednotku.

Při převodu na větší jednotku se zlomková část zahodí: 999 milisekund odpovídá 0 sekundám. Při přetečení se výsledek omezí na Long.MIN_VALUE nebo Long.MAX_VALUE, místo aby se přetočil.

Jednotka nanosekund nezaručuje přesnost časování na úrovni nanosekund. Příklad provádí pouze deterministické převody a na nic nečeká.

Příklady

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

Výsledek

2000000
0
9223372036854775807

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje