CKTIS / Java
Vytváření, sčítání a převod hodnot Duration
Vytvořte dobu trvání z počtu minut nebo ze dvou časových okamžiků, přičtěte další dobu a zjistěte celkový počet minut nebo hodin.
Verze: Java SE 21
Syntaxe
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()V Java SE 21 představuje java.time.Duration neměnnou dobu trvání se znaménkem, nikoli datum ani denní čas. Statická tovární metoda Duration.ofMinutes(long minutes) vytvoří dobu trvání ze zadaného počtu minut, který může být záporný. Každá minuta má přesně 60 sekund.
Statická metoda Duration.between(start, end) vypočítá rozdíl od začátku včetně do konce bez zahrnutí koncového okamžiku. Pokud konec předchází začátku, výsledek je záporný. Oba argumenty musí podporovat jednotku SECONDS. Liší-li se jejich typy, výpočet vychází z typu prvního argumentu. Pokud nelze zjistit rozdíl v sekundách, metoda vyvolá DateTimeException.
Pro dvě hodnoty Duration vrátí a.plus(b) jejich součet, aniž by některou z nich změnila. Chcete-li součet použít, uložte si návratovou hodnotu. Přetížená varianta plus(long, TemporalUnit) přijímá množství a jednotku s přesnou délkou, například ChronoUnit.MINUTES. Výjimkou je ChronoUnit.DAYS, kde den znamená 24 hodin. Nepodporovaná jednotka vede k výjimce UnsupportedTemporalTypeException. Pokud výsledek překročí rozsah Duration, metody ofMinutes, between i obě varianty plus vyvolají ArithmeticException.
toMinutes() a toHours() vracejí celkové počty typu long, nikoli minutovou či hodinovou složku. Uložené sekundy dělí 60, respektive 3600, celočíselně směrem k nule a bez zohlednění pole nanosekund. Pro 95 minut vracejí 95 a 1, zatímco toMinutesPart() vrátí 35.
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-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());
}
}Výsledek
elapsed.toMinutes() = 75 total.toMinutes() = 95 total.toHours() = 1
Mezi pevně zadanými okamžiky uplyne 75 minut. Přičtením 20 minut vznikne 95 minut, tedy 1 celá hodina. `elapsed` stále představuje 75 minut.
Související lekce
- Java · Lekce 68 · Základní · Verze: 2