KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Duration-waarden maken, optellen en omrekenen

Maak een tijdsduur uit een aantal minuten of twee tijdstippen, tel er een andere tijdsduur bij op en lees het totaal in minuten of uren af.

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

In Java SE 21 stelt java.time.Duration een onveranderlijke tijdsduur met teken voor, geen datum of tijdstip. De statische fabrieksmethode Duration.ofMinutes(long minutes) maakt een tijdsduur op basis van een aantal minuten, dat ook negatief mag zijn. Een minuut duurt precies 60 seconden.

De statische methode Duration.between(start, end) berekent het verschil vanaf het begin (inclusief) tot het einde (exclusief). Ligt het einde vóór het begin, dan is het resultaat negatief. Beide argumenten moeten de eenheid SECONDS ondersteunen. Bij verschillende typen is het type van het eerste argument bepalend voor de berekening. Als het verschil in seconden niet kan worden bepaald, werpt de methode een DateTimeException.

Voor twee Duration-waarden geeft a.plus(b) de som terug zonder een van beide te wijzigen. Bewaar de geretourneerde waarde als je de som wilt gebruiken. De overload plus(long, TemporalUnit) neemt een hoeveelheid en een eenheid met een exacte duur, zoals ChronoUnit.MINUTES. De uitzondering is ChronoUnit.DAYS: een dag telt als 24 uur. Een niet-ondersteunde eenheid leidt tot UnsupportedTemporalTypeException. ofMinutes, between en beide overloads van plus werpen ArithmeticException als het resultaat buiten het bereik van Duration valt.

toMinutes() en toHours() geven totalen terug als long, geen losse minuten- of urencomponenten. Ze delen de opgeslagen seconden door respectievelijk 60 of 3600, met gehele deling richting nul en zonder het nanosecondenveld mee te tellen. Bij 95 minuten zijn de totalen respectievelijk 95 en 1, terwijl toMinutesPart() 35 teruggeeft.

Voorbeelden

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

Resultaat

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

De vaste tijdstippen liggen 75 minuten uit elkaar. Met 20 minuten erbij komt het totaal op 95 minuten, oftewel 1 heel uur. `elapsed` staat nog steeds voor 75 minuten.

Gerelateerde lessen

  • Java · Les 68 · Basis · Versie: 2

Bronnen