CKTIS / Java
Duration — uplynutý čas a rozdiely medzi okamihmi
java.time.Duration predstavuje množstvo času v sekundách a nanosekundách. Duration.between vypočíta rozdiel medzi kompatibilnými časovými objektmi; výsledok môže byť kladný, nulový alebo záporný.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
Duration.between(Temporal startInclusive, Temporal endExclusive)java.time.Duration je nemenná a bezpečná na použitie z viacerých vlákien. Predstavuje množstvo času, nie dátum ani okamih. Ukladá sekundy a zlomok sekundy vyjadrený v nanosekundách. Na rozdiel od kalendárneho Period znamená deň v Duration vždy 24 hodín, bez ohľadu na zmeny letného času.
Duration.between(startInclusive, endExclusive) vypočíta rozdiel od začiatku (vrátane) po koniec (bez jeho započítania). Argumenty musia podporovať SECONDS; úplná presnosť vyžaduje aj NANOS alebo NANO_OF_SECOND. Ak majú argumenty rôzne typy, typ prvého určuje, ako sa interpretuje druhý. Ak je začiatok typu LocalDateTime, koniec môže byť typu OffsetDateTime: jeho posun voči UTC sa ignoruje. V opačnom poradí volanie vyvolá výnimku DateTimeException, pretože LocalDateTime nemá posun voči UTC. Nekompatibilné objekty môžu spôsobiť DateTimeException, zatiaľ čo pretečenie spôsobí ArithmeticException.
Príklad používa pevné hodnoty Instant, takže nezávisí od hodín ani predvoleného časového pásma. Výsledok PT1H30M45S znamená 1 hodinu, 30 minút a 45 sekúnd. toMinutes() vracia celkový počet celých minút, teda 90, nie minútovú zložku 30. V tomto príklade sa po výmene poradia argumentov vypočíta záporné trvanie.
Príklady
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());
}
}Výsledok
PT1H30M45S 90 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.