CKTIS / Java
Duration — proteklo vrijeme i razlike između vremenskih trenutaka
java.time.Duration predstavlja količinu vremena u sekundama i nanosekundama. Duration.between izračunava razliku između kompatibilnih vremenskih objekata; rezultat može biti pozitivan, nula ili negativan.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Duration.between(Temporal startInclusive, Temporal endExclusive)java.time.Duration predstavlja nepromjenjivu količinu vremena i siguran je za uporabu u više dretvi. Ne predstavlja datum ni vremenski trenutak. Pohranjuje sekunde i dio sekunde izražen u nanosekundama. Za razliku od kalendarskog Period, dan u Duration uvijek znači 24 sata, bez obzira na promjene ljetnog računanja vremena.
Duration.between(startInclusive, endExclusive) izračunava razliku od uključenog početka do isključenog kraja. Argumenti moraju podržavati SECONDS; za punu preciznost potreban je i NANOS ili NANO_OF_SECOND. Ako su argumenti različitih tipova, tip prvog određuje kako se tumači drugi. Ako je početak tipa LocalDateTime, kraj može biti tipa OffsetDateTime: njegov se pomak u odnosu na UTC zanemaruje. U obrnutom redoslijedu poziv izaziva iznimku DateTimeException jer LocalDateTime nema pomak u odnosu na UTC. Nekompatibilni objekti mogu uzrokovati DateTimeException, a prekoračenje ArithmeticException.
Primjer koristi fiksne vrijednosti Instant, pa ne ovisi o satu ni zadanoj vremenskoj zoni. Rezultat PT1H30M45S znači 1 sat, 30 minuta i 45 sekundi. toMinutes() vraća ukupan broj cijelih minuta, odnosno 90, a ne komponentu minuta 30. U ovom primjeru zamjena redoslijeda argumenata daje negativno trajanje.
Primjeri
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());
}
}Rezultat
PT1H30M45S 90 true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.