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

CKTIS / Java

Създаване, събиране и преобразуване на стойности Duration

Създай продължителност от брой минути или два момента, добави друга продължителност и получи общия брой минути или часове.

Версия: Java SE 21

Синтаксис

import java.time.Duration;
import java.time.temporal.Temporal;
import java.time.temporal.TemporalUnit;

// Static methods declared by Duration
public static Duration between(Temporal startInclusive, Temporal endExclusive)
public static Duration ofMinutes(long minutes)

// Instance methods declared by Duration
public Duration plus(Duration duration)
public Duration plus(long amountToAdd, TemporalUnit unit)
public long toHours()
public long toMinutes()

В Java SE 21 java.time.Duration представлява неизменяема продължителност със знак, а не дата или час от денонощието. Статичният фабричен метод Duration.ofMinutes(long minutes) създава продължителност от брой минути, който може да е отрицателен. Всяка минута е точно 60 секунди.

Статичният метод Duration.between(start, end) изчислява разликата от началния момент включително до крайния момент невключително. Ако краят предхожда началото, резултатът е отрицателен. И двата аргумента трябва да поддържат единицата SECONDS. Ако типовете им са различни, изчислението се основава на типа на първия аргумент. Ако разликата в секунди не може да се определи, методът хвърля DateTimeException.

За две стойности Duration извикването a.plus(b) връща сбора, без да променя нито една от тях. Запази върнатата стойност, за да използваш сбора. Претовареният вариант plus(long, TemporalUnit) приема количество и единица с точна продължителност, например ChronoUnit.MINUTES. Изключение е ChronoUnit.DAYS, при която един ден се приема за 24 часа. Неподдържана единица води до UnsupportedTemporalTypeException. Ако резултатът е извън диапазона на Duration, ofMinutes, between и двата варианта на plus хвърлят ArithmeticException.

toMinutes() и toHours() връщат общия брой единици като long, а не минутната или часовата съставка. Те делят записаните секунди съответно на 60 или 3600, като използват целочислено деление към нулата и пренебрегват полето за наносекунди. За 95 минути резултатите са съответно 95 и 1, а toMinutesPart() връща 35.

Примери

import java.time.Duration;
import java.time.Instant;

public class Main {
    public static void main(String[] args) {
        Instant start = Instant.parse("2025-01-01T09:00:00Z");
        Instant end = Instant.parse("2025-01-01T10:15:00Z");
        Duration elapsed = Duration.between(start, end);
        Duration extra = Duration.ofMinutes(20);
        Duration total = elapsed.plus(extra);

        System.out.println("elapsed.toMinutes() = " + elapsed.toMinutes());
        System.out.println("total.toMinutes() = " + total.toMinutes());
        System.out.println("total.toHours() = " + total.toHours());
    }
}

Резултат

elapsed.toMinutes() = 75
total.toMinutes() = 95
total.toHours() = 1

Между зададените моменти изминават 75 минути. С добавени 20 минути сборът е 95 минути, тоест 1 цял час. `elapsed` продължава да представлява 75 минути.

Свързани уроци

  • Java · Урок 68 · Начално · Версия: 2

Източници