CKTIS / Java
Duration — uplynulý čas a rozdíly mezi okamžiky
java.time.Duration představuje dobu v sekundách a nanosekundách. Duration.between vypočítá rozdíl mezi kompatibilními časovými objekty; výsledek může být kladný, nulový nebo záporný.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
Duration.between(Temporal startInclusive, Temporal endExclusive)java.time.Duration je neměnná a bezpečná pro použití z více vláken. Představuje dobu, nikoli datum nebo okamžik. Ukládá sekundy a zlomek sekundy vyjádřený v nanosekundách. Na rozdíl od kalendářního Period znamená den v Duration vždy 24 hodin, bez ohledu na změny letního času.
Duration.between(startInclusive, endExclusive) vypočítá rozdíl od začátku (včetně) do konce (bez jeho započtení). Argumenty musí podporovat SECONDS; plná přesnost vyžaduje také NANOS nebo NANO_OF_SECOND. Pokud mají argumenty různé typy, typ prvního určuje, jak se interpretuje druhý. Je-li začátek typu LocalDateTime, konec může být typu OffsetDateTime: jeho posun vůči UTC se ignoruje. V opačném pořadí volání vyvolá výjimku DateTimeException, protože LocalDateTime nemá posun vůči UTC. Nekompatibilní objekty mohou způsobit DateTimeException, zatímco přetečení způsobí ArithmeticException.
Příklad používá pevné hodnoty Instant, takže nezávisí na hodinách ani výchozím časovém pásmu. Výsledek PT1H30M45S znamená 1 hodinu, 30 minut a 45 sekund. toMinutes() vrací celkový počet celých minut, tedy 90, nikoli minutovou složku 30. V tomto příkladu se po prohození argumentů vypočítá záporná doba trvání.
Pří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ýsledek
PT1H30M45S 90 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.