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

CKTIS / Java

Créer, additionner et convertir des valeurs Duration

Créez une durée à partir d’un nombre de minutes ou de deux instants, ajoutez une autre durée et obtenez le total en minutes ou en heures.

Version : Java SE 21

Syntaxe

import java.time.Duration;
import java.time.temporal.Temporal;
import java.time.temporal.TemporalUnit;

// Static methods declared by Duration
public static Duration between(Temporal startInclusive, Temporal endExclusive)
public static Duration ofMinutes(long minutes)

// Instance methods declared by Duration
public Duration plus(Duration duration)
public Duration plus(long amountToAdd, TemporalUnit unit)
public long toHours()
public long toMinutes()

Dans Java SE 21, java.time.Duration représente une durée signée et immuable, et non une date ou une heure de la journée. La méthode de fabrique statique Duration.ofMinutes(long minutes) crée une durée à partir d’un nombre de minutes, qui peut être négatif. Une minute vaut exactement 60 secondes.

La méthode statique Duration.between(start, end) calcule la différence entre le début inclus et la fin exclue. Le résultat est négatif si la fin précède le début. Les deux arguments doivent prendre en charge l’unité SECONDS. Si leurs types diffèrent, le calcul se fonde sur le type du premier argument. Si la différence en secondes ne peut pas être obtenue, la méthode lève une DateTimeException.

Pour deux valeurs Duration, a.plus(b) renvoie leur somme sans modifier aucune des deux. Conservez la valeur renvoyée pour réutiliser la somme. La surcharge plus(long, TemporalUnit) prend un nombre et une unité de durée exacte, comme ChronoUnit.MINUTES. L’exception est ChronoUnit.DAYS : un jour compte pour 24 heures. Une unité non prise en charge provoque une UnsupportedTemporalTypeException. ofMinutes, between et les deux surcharges de plus lèvent une ArithmeticException si le résultat dépasse la capacité de Duration.

toMinutes() et toHours() renvoient des totaux de type long, et non des composantes de minutes ou d’heures. Elles divisent les secondes stockées par 60 ou 3600, respectivement, avec une division entière vers zéro, sans tenir compte du champ des nanosecondes. Pour 95 minutes, les totaux sont respectivement 95 et 1, tandis que toMinutesPart() renvoie 35.

Exemples

import java.time.Duration;
import java.time.Instant;

public class Main {
    public static void main(String[] args) {
        Instant start = Instant.parse("2025-01-01T09:00:00Z");
        Instant end = Instant.parse("2025-01-01T10:15:00Z");
        Duration elapsed = Duration.between(start, end);
        Duration extra = Duration.ofMinutes(20);
        Duration total = elapsed.plus(extra);

        System.out.println("elapsed.toMinutes() = " + elapsed.toMinutes());
        System.out.println("total.toMinutes() = " + total.toMinutes());
        System.out.println("total.toHours() = " + total.toHours());
    }
}

Résultat

elapsed.toMinutes() = 75
total.toMinutes() = 95
total.toHours() = 1

Les instants fixés sont espacés de 75 minutes. Avec 20 minutes de plus, le total passe à 95 minutes, soit 1 heure entière. `elapsed` représente toujours 75 minutes.

Leçons associées

  • Java · Leçon 68 · Débutant · Version : 2

Sources