Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri