CKTIS / Java
Creare, sommare e convertire valori Duration
Crea una durata da un numero di minuti o da due istanti, aggiungi un’altra durata e leggi il totale espresso in minuti o in ore.
Versione: Java SE 21
Sintassi
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()In Java SE 21, java.time.Duration rappresenta una durata immutabile con segno, non una data né un’ora del giorno. Il metodo factory statico Duration.ofMinutes(long minutes) crea una durata da un numero di minuti che può anche essere negativo. Ogni minuto equivale esattamente a 60 secondi.
Il metodo statico Duration.between(start, end) calcola la differenza dall’inizio incluso alla fine esclusa. Il risultato è negativo se la fine precede l’inizio. Entrambi gli argomenti devono supportare l’unità SECONDS. Se i tipi sono diversi, il calcolo si basa sul tipo del primo argomento. Se non è possibile ottenere la differenza in secondi, il metodo lancia DateTimeException.
Dati due valori Duration, a.plus(b) restituisce la somma senza modificare nessuno dei due; conserva il valore restituito per usare la somma. L’overload plus(long, TemporalUnit) accetta una quantità e un’unità di durata esatta, come ChronoUnit.MINUTES. Fa eccezione ChronoUnit.DAYS, che vale 24 ore per giorno. Un’unità non supportata causa UnsupportedTemporalTypeException. ofMinutes, between ed entrambi gli overload di plus lanciano ArithmeticException se il risultato non rientra nell’intervallo rappresentabile da Duration.
toMinutes() e toHours() restituiscono i totali come long, non le componenti dei minuti o delle ore. Dividono i secondi memorizzati rispettivamente per 60 o 3600, con divisione intera verso zero e senza considerare il campo dei nanosecondi. Per 95 minuti, i totali sono rispettivamente 95 e 1, mentre toMinutesPart() restituisce 35.
Esempi
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());
}
}Risultato
elapsed.toMinutes() = 75 total.toMinutes() = 95 total.toHours() = 1
Tra i due istanti fissati passano 75 minuti. Aggiungendo 20 minuti si ottengono 95 minuti, cioè 1 ora intera. `elapsed` continua a rappresentare 75 minuti.
Lezioni correlate
- Java · Lezione 68 · Base · Versione: 2