Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Vytváranie, sčítanie a prevod hodnôt Duration

Vytvorte trvanie z počtu minút alebo z dvoch časových okamihov, pripočítajte ďalšie trvanie a zistite celkový počet minút alebo hodín.

Verzia: Java SE 21

Syntax

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 predstavuje java.time.Duration nemenné trvanie so znamienkom, nie dátum ani denný čas. Statická továrenská metóda Duration.ofMinutes(long minutes) vytvorí trvanie zo zadaného počtu minút, ktorý môže byť záporný. Každá minúta má presne 60 sekúnd.

Statická metóda Duration.between(start, end) vypočíta rozdiel od začiatku vrátane po koniec bez zahrnutia koncového okamihu. Ak koniec predchádza začiatku, výsledok je záporný. Oba argumenty musia podporovať jednotku SECONDS. Ak majú rôzne typy, výpočet vychádza z typu prvého argumentu. Ak sa rozdiel v sekundách nedá zistiť, metóda vyvolá DateTimeException.

Pre dve hodnoty Duration vráti a.plus(b) ich súčet bez toho, aby niektorú zmenila. Ak chcete súčet použiť, uložte si návratovú hodnotu. Preťažená verzia plus(long, TemporalUnit) prijíma množstvo a jednotku s presnou dĺžkou, napríklad ChronoUnit.MINUTES. Výnimkou je ChronoUnit.DAYS, kde deň znamená 24 hodín. Nepodporovaná jednotka spôsobí UnsupportedTemporalTypeException. Ak je výsledok mimo rozsahu Duration, metódy ofMinutes, between aj obe verzie plus vyvolajú ArithmeticException.

toMinutes() a toHours() vracajú celkové počty typu long, nie minútovú či hodinovú zložku. Uložené sekundy delia 60, respektíve 3600, celočíselne smerom k nule a bez zohľadnenia poľa nanosekúnd. Pre 95 minút vrátia 95 a 1, zatiaľ čo toMinutesPart() vráti 35.

Prí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ýsledok

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

Medzi pevne zadanými okamihmi uplynie 75 minút. Pripočítaním 20 minút dostanete 95 minút, teda 1 celú hodinu. `elapsed` stále predstavuje 75 minút.

Súvisiace lekcie

  • Java · Lekcia 68 · Základná · Verzia: 2

Zdroje