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.