Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

TimeUnit — unités de temps et conversions

TimeUnit décrit les unités de temps utilisées notamment pour les délais d’attente. Il permet de convertir des valeurs long, en tronquant les parties fractionnaires ou en saturant en cas de dépassement.

Version : 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 est une énumération qui décrit des unités de temps, utilisées notamment dans les opérations avec délai d’attente. Elle ne stocke ni ne mesure le temps elle-même.

TimeUnit.MILLISECONDS désigne les millisecondes. La méthode d’instance TimeUnit.toNanos(long duration) interprète l’argument dans l’unité du récepteur : TimeUnit.MILLISECONDS.toNanos(2L) renvoie 2000000L. L’appel équivalent est TimeUnit.NANOSECONDS.convert(2L, TimeUnit.MILLISECONDS) — le récepteur de convert définit l’unité cible.

La conversion vers une unité plus grande supprime la partie fractionnaire : 999 millisecondes donnent 0 seconde. En cas de dépassement, le résultat est plafonné à Long.MIN_VALUE ou Long.MAX_VALUE, au lieu de revenir au début de la plage.

Une unité en nanosecondes ne garantit pas une précision de temporisation à la nanoseconde. L’exemple effectue uniquement des conversions déterministes, sans attente.

Exemples

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

Résultat

2000000
0
9223372036854775807

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources