CKTIS / Java
Duration — temps écoulé et différences entre instants
java.time.Duration représente une durée en secondes et en nanosecondes. Duration.between calcule la différence entre des objets temporels compatibles ; le résultat peut être positif, nul ou négatif.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
Duration.between(Temporal startInclusive, Temporal endExclusive)java.time.Duration représente une durée immuable et utilisable de façon sûre par plusieurs threads, et non une date ou un instant. Elle stocke des secondes et une fraction de seconde exprimée en nanosecondes. Contrairement à Period, qui repose sur le calendrier, un jour dans Duration signifie toujours 24 heures, sans tenir compte des changements d’heure saisonniers.
Duration.between(startInclusive, endExclusive) calcule la différence entre le début inclus et la fin exclue. Les arguments doivent prendre en charge SECONDS ; une précision complète nécessite aussi NANOS ou NANO_OF_SECOND. Si les arguments sont de types différents, le type du premier détermine comment le second est interprété. Si le début est un LocalDateTime, la fin peut être un OffsetDateTime : son décalage par rapport à UTC est ignoré. Dans l’ordre inverse, l’appel lève une DateTimeException, car LocalDateTime n’a pas de décalage par rapport à UTC. Des objets incompatibles peuvent provoquer une DateTimeException, tandis qu’un dépassement de capacité provoque une ArithmeticException.
L’exemple utilise des valeurs Instant fixes ; il ne dépend donc ni de l’horloge ni du fuseau horaire par défaut. Le résultat PT1H30M45S signifie 1 heure, 30 minutes et 45 secondes. toMinutes() renvoie le nombre total de minutes entières, soit 90, et non la composante des minutes 30. Dans cet exemple, l’inversion des arguments donne une durée négative.
Exemples
import java.time.Duration;
import java.time.Instant;
public class Main {
public static void main(String[] args) {
Instant start = Instant.parse("2025-01-01T10:00:00Z");
Instant end = Instant.parse("2025-01-01T11:30:45Z");
Duration elapsed = Duration.between(start, end);
System.out.println(elapsed);
System.out.println(elapsed.toMinutes());
System.out.println(Duration.between(end, start).isNegative());
}
}Résultat
PT1H30M45S 90 true
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.