Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

TimeUnit — unidades de tiempo y conversiones

TimeUnit describe unidades de tiempo utilizadas, entre otros casos, para los tiempos límite. Permite convertir valores long, descartando las partes fraccionarias o saturando cuando se produce un desbordamiento.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

java.util.concurrent.TimeUnit es una enumeración que describe unidades de tiempo y se utiliza, entre otros casos, en operaciones con tiempo límite. No almacena ni mide el tiempo por sí misma.

TimeUnit.MILLISECONDS representa milisegundos. El método de instancia TimeUnit.toNanos(long duration) interpreta el argumento en la unidad del receptor: TimeUnit.MILLISECONDS.toNanos(2L) devuelve 2000000L. La llamada equivalente es TimeUnit.NANOSECONDS.convert(2L, TimeUnit.MILLISECONDS); el receptor de convert determina la unidad de destino.

Al convertir a una unidad mayor, se descarta la parte fraccionaria: 999 milisegundos se convierten en 0 segundos. Si se produce un desbordamiento, el resultado se limita a Long.MIN_VALUE o Long.MAX_VALUE, en lugar de volver al inicio del rango.

Una unidad de nanosegundos no garantiza una precisión de temporización de nanosegundos. El ejemplo solo realiza conversiones deterministas, sin esperar.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes