Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

TimeUnit — unidades de tempo e conversões

TimeUnit descreve unidades de tempo usadas, por exemplo, em operações com limites de espera. Permite converter valores long, descartando partes fracionárias ou saturando em caso de overflow.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

java.util.concurrent.TimeUnit é uma enumeração que descreve unidades de tempo, usadas nomeadamente em operações com limites de espera. Não armazena nem mede o tempo por si própria.

TimeUnit.MILLISECONDS representa milissegundos. O método de instância TimeUnit.toNanos(long duration) interpreta o argumento na unidade do recetor: TimeUnit.MILLISECONDS.toNanos(2L) devolve 2000000L. A chamada equivalente é TimeUnit.NANOSECONDS.convert(2L, TimeUnit.MILLISECONDS) — o recetor de convert especifica a unidade de destino.

A conversão para uma unidade maior descarta a parte fracionária: 999 milissegundos correspondem a 0 segundos. Em caso de overflow, o resultado é limitado a Long.MIN_VALUE ou Long.MAX_VALUE, em vez de voltar ao início do intervalo.

Uma unidade de nanossegundos não garante uma precisão de temporização ao nanossegundo. O exemplo executa apenas conversões determinísticas, sem qualquer espera.

Exemplos

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

Resultado

2000000
0
9223372036854775807

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes