Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Duration — tempo trascorso e differenze tra istanti

java.time.Duration rappresenta una quantità di tempo in secondi e nanosecondi. Duration.between calcola la differenza tra oggetti temporali compatibili; il risultato può essere positivo, zero o negativo.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

Duration.between(Temporal startInclusive, Temporal endExclusive)

java.time.Duration rappresenta una quantità di tempo immutabile e thread-safe, non una data né un istante. Memorizza secondi e una frazione di secondo espressa in nanosecondi. A differenza di Period, che si basa sul calendario, un giorno in Duration significa sempre 24 ore, senza tenere conto dei cambiamenti dell’ora legale.

Duration.between(startInclusive, endExclusive) calcola la differenza dall’inizio incluso alla fine esclusa. Gli argomenti devono supportare SECONDS; per la precisione completa è necessario anche NANOS o NANO_OF_SECOND. Se gli argomenti sono di tipo diverso, il tipo del primo determina come viene interpretato il secondo. Se l’inizio è un LocalDateTime, la fine può essere un OffsetDateTime: il suo offset rispetto a UTC viene ignorato. Nell’ordine inverso, la chiamata genera una DateTimeException, perché LocalDateTime non ha un offset rispetto a UTC. Oggetti incompatibili possono causare DateTimeException, mentre un overflow causa ArithmeticException.

L’esempio usa valori Instant fissi, quindi non dipende dall’orologio né dal fuso orario predefinito. Il risultato PT1H30M45S significa 1 ora, 30 minuti e 45 secondi. toMinutes() restituisce il numero totale di minuti interi, cioè 90, non la componente dei minuti 30. In questo esempio, invertendo l’ordine degli argomenti si ottiene una durata negativa.

Esempi

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

Risultato

PT1H30M45S
90
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti