Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

TimeUnit — unità di tempo e conversioni

TimeUnit descrive le unità di tempo usate, per esempio, nelle operazioni con timeout. Consente di convertire valori long, troncando le parti frazionarie o saturando in caso di overflow.

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

Sintassi

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

java.util.concurrent.TimeUnit è un enum che descrive unità di tempo, usate anche nelle operazioni con timeout. Non memorizza né misura il tempo di per sé.

TimeUnit.MILLISECONDS indica i millisecondi. Il metodo di istanza TimeUnit.toNanos(long duration) interpreta l’argomento nell’unità del ricevente: TimeUnit.MILLISECONDS.toNanos(2L) restituisce 2000000L. La chiamata equivalente è TimeUnit.NANOSECONDS.convert(2L, TimeUnit.MILLISECONDS) — il ricevente di convert specifica l’unità di destinazione.

La conversione a un’unità più grande scarta la parte frazionaria: 999 millisecondi diventano 0 secondi. In caso di overflow, il risultato viene limitato a Long.MIN_VALUE o Long.MAX_VALUE, invece di tornare all’inizio dell’intervallo.

Un’unità in nanosecondi non garantisce una precisione di temporizzazione al nanosecondo. L’esempio esegue solo conversioni deterministiche, senza attese.

Esempi

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

Risultato

2000000
0
9223372036854775807

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti