Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Tworzenie, dodawanie i przeliczanie wartości Duration

Utwórz czas trwania z liczby minut lub z dwóch punktów w czasie, dodaj drugi czas trwania i odczytaj łączną liczbę minut albo godzin.

Wersja: Java SE 21

Składnia

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

W Java SE 21 java.time.Duration oznacza niezmienny czas trwania ze znakiem, a nie datę ani porę dnia. Statyczna metoda Duration.ofMinutes(long minutes) tworzy czas trwania z podanej liczby minut, także ujemnej. Każda minuta ma dokładnie 60 sekund.

Statyczna metoda Duration.between(start, end) oblicza różnicę od początku włącznie do końca wyłącznie. Wynik jest ujemny, jeśli koniec jest wcześniejszy niż początek. Argumenty muszą obsługiwać jednostkę SECONDS. Jeśli mają różne typy, obliczenie opiera się na typie pierwszego argumentu. Jeśli nie da się ustalić różnicy w sekundach, metoda zgłasza DateTimeException.

Metoda instancyjna a.plus(b) dla dwóch wartości Duration zwraca sumę bez zmiany a ani b; zapisz zwrócony wynik, aby użyć go dalej. Przeciążenie plus(long, TemporalUnit) przyjmuje liczbę i jednostkę o dokładnej długości, np. ChronoUnit.MINUTES. Wyjątkiem jest ChronoUnit.DAYS, gdzie dzień oznacza 24 godziny. Nieobsługiwana jednostka powoduje UnsupportedTemporalTypeException. ofMinutes, between i oba przeciążenia plus zgłaszają ArithmeticException, gdy wynik wykracza poza zakres Duration.

toMinutes() i toHours() zwracają łączną liczbę jednostek jako long, a nie składową minut lub godzin. Dzielą zapisane sekundy odpowiednio przez 60 lub 3600, stosując dzielenie całkowite w kierunku zera, bez uwzględniania pola nanosekund. Dla 95 minut wynik to odpowiednio 95 i 1, a toMinutesPart() zwraca 35.

Przykłady

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

Wynik

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

Między ustalonymi punktami w czasie upływa 75 minut. Po dodaniu 20 minut suma wynosi 95 minut, czyli 1 pełną godzinę. `elapsed` nadal oznacza 75 minut.

Powiązane lekcje

  • Java · Lekcja 68 · Podstawowy · Wersja: 2

Źródła