CKTIS / Java
Duration — pretekli čas in razlike med trenutki
java.time.Duration predstavlja trajanje v sekundah in nanosekundah. Duration.between izračuna razliko med združljivimi časovnimi objekti; rezultat je lahko pozitiven, ničeln ali negativen.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Duration.between(Temporal startInclusive, Temporal endExclusive)java.time.Duration predstavlja trajanje, ne datuma ali trenutka. Je nespremenljiv in varen za uporabo v več nitih. Hrani sekunde in del sekunde, izražen v nanosekundah. Za razliko od koledarskega Period dan v Duration vedno pomeni 24 ur, ne glede na prehode na poletni ali zimski čas.
Duration.between(startInclusive, endExclusive) izračuna razliko od vključenega začetka do izključenega konca. Argumenta morata podpirati SECONDS; za polno natančnost je potreben tudi NANOS ali NANO_OF_SECOND. Če sta argumenta različnih tipov, tip prvega določa, kako se interpretira drugi. Če je začetek tipa LocalDateTime, je konec lahko tipa OffsetDateTime: njegov odmik od UTC se ne upošteva. V obratnem vrstnem redu klic sproži izjemo DateTimeException, ker LocalDateTime nima odmika od UTC. Nezdružljivi objekti lahko povzročijo DateTimeException, prekoračitev pa povzroči ArithmeticException.
Primer uporablja fiksne vrednosti Instant, zato ni odvisen od ure ali privzetega časovnega pasu. Rezultat PT1H30M45S pomeni 1 uro, 30 minut in 45 sekund. toMinutes() vrne skupno število celih minut, torej 90, ne pa minutne komponente 30. Če v tem primeru argumenta zamenjamo, dobimo negativno trajanje.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.