База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Duration — изминало време и разлики между моменти

java.time.Duration представя количество време в секунди и наносекунди. Duration.between изчислява разликата между съвместими времеви обекти; резултатът може да е положителен, нулев или отрицателен.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

Duration.between(Temporal startInclusive, Temporal endExclusive)

java.time.Duration представя количество време, а не дата или момент. Обектите от този тип са неизменяеми и безопасни за използване от множество нишки. Съхраняват секунди и част от секундата, изразена в наносекунди. За разлика от календарния Period, денят в Duration винаги означава 24 часа, без да се отчитат преминаванията към лятно или зимно часово време.

Duration.between(startInclusive, endExclusive) изчислява разликата от началото (включително) до края (без да го включва). Аргументите трябва да поддържат SECONDS; за пълна точност е необходим и NANOS или NANO_OF_SECOND. Ако аргументите са от различни типове, типът на първия определя как се интерпретира вторият. Ако началото е от тип LocalDateTime, краят може да е от тип OffsetDateTime: отместването му спрямо UTC се пренебрегва. При обратния ред извикването хвърля DateTimeException, защото LocalDateTime няма отместване спрямо UTC. Несъвместимите обекти могат да причинят DateTimeException, а препълването причинява ArithmeticException.

Примерът използва фиксирани стойности Instant, затова не зависи от часовника или часовата зона по подразбиране. Резултатът PT1H30M45S означава 1 час, 30 минути и 45 секунди. toMinutes() връща общия брой цели минути, тоест 90, а не минутната компонента 30. В този пример размяната на аргументите дава отрицателна продължителност.

Примери

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());
    }
}

Резултат

PT1H30M45S
90
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници