CKTIS / Java
Duration — verstreken tijd en verschillen tussen tijdstippen
java.time.Duration stelt een hoeveelheid tijd in seconden en nanoseconden voor. Duration.between berekent het verschil tussen compatibele tijdobjecten; het resultaat kan positief, nul of negatief zijn.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
Duration.between(Temporal startInclusive, Temporal endExclusive)java.time.Duration is een onveranderlijke, threadveilige hoeveelheid tijd en geen datum of tijdstip. De klasse slaat seconden op en drukt de fractie van een seconde uit in nanoseconden. Anders dan bij het kalendergebaseerde Period betekent een dag in Duration altijd 24 uur, zonder rekening te houden met veranderingen door de zomertijd.
Duration.between(startInclusive, endExclusive) berekent het verschil van het begin (inclusief) tot het einde (exclusief). De argumenten moeten SECONDS ondersteunen; voor volledige precisie is ook NANOS of NANO_OF_SECOND nodig. Bij verschillende typen bepaalt het type van het eerste argument hoe het tweede wordt geïnterpreteerd. Als het begin een LocalDateTime is, kan het einde een OffsetDateTime zijn: de UTC-offset daarvan wordt genegeerd. In omgekeerde volgorde gooit de aanroep een DateTimeException, omdat LocalDateTime geen UTC-offset heeft. Incompatibele objecten kunnen een DateTimeException veroorzaken; bij overflow ontstaat een ArithmeticException.
Het voorbeeld gebruikt vaste Instant-waarden en is daardoor niet afhankelijk van de klok of de standaardtijdzone. Het resultaat PT1H30M45S betekent 1 uur, 30 minuten en 45 seconden. toMinutes() geeft het totale aantal hele minuten terug, namelijk 90, niet de minutencomponent 30. In dit voorbeeld levert het omwisselen van de argumenten een negatieve duur op.
Voorbeelden
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());
}
}Resultaat
PT1H30M45S 90 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.