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.