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.