Package org.djunits.quantity

Class Duration

java.lang.Object

java.lang.Number

org.djunits.quantity.def.Quantity<Duration,Duration.Unit>

org.djunits.quantity.Duration

All Implemented Interfaces:

Serializable, Comparable<Duration>, Additive<Duration>, Scalable<Duration>, Value<Duration.Unit,Duration>

public class Duration
extends Quantity<Duration,Duration.Unit>

Duration is the interval of time between two events, measured in seconds (s). This quantity encodes a relative amount of time. The Time quantity encodes an absolute time instant.

Copyright (c) 2025-2026 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information https://djunits.org. The DJUNITS project is distributed under a three-clause BSD-style license.

Author:

Alexander Verbraeck

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Duration.Unit	Duration.Unit encodes the units of relative time.

Field Summary

Fields

Modifier and Type	Field	Description
static final Duration	NaN	Constant with value NaN.
static final Duration	NEG_MAXVALUE	Constant with value -MAX_VALUE.
static final Duration	NEGATIVE_INFINITY	Constant with value NEGATIVE_INFINITY.
static final Duration	ONE	Constant with value one.
static final Duration	POS_MAXVALUE	Constant with value MAX_VALUE.
static final Duration	POSITIVE_INFINITY	Constant with value POSITIVE_INFINITY.
static final Duration	ZERO	Constant with value zero.

Constructor Summary

Constructors

Constructor	Description
Duration(double value, String abbreviation)	Instantiate a Duration quantity with a unit, expressed as a String.
Duration(double value, Duration.Unit unit)	Instantiate a Duration quantity with a unit.
Duration(Duration value)	Construct Duration quantity.

Method Summary

Modifier and Type	Method	Description
final Time	add(Time time)	Add an (absolute) time to this duration, and return a time.
final Dimensionless	divide(Duration v)	Calculate the division of Duration and Duration, which results in a Dimensionless quantity.
Duration	instantiate(double si)	Instantiate a quantity with an SI or base value.
final Speed	multiply(Acceleration v)	Calculate the multiplication of Duration and Acceleration, which results in a Speed scalar.
final AngularVelocity	multiply(AngularAcceleration v)	Calculate the multiplication of Duration and AngularAcceleration, which results in a AngularVelocity scalar.
final Angle	multiply(AngularVelocity v)	Calculate the multiplication of Duration and AngularVelocity, which results in a Angle scalar.
final ElectricalCapacitance	multiply(ElectricalConductance v)	Calculate the multiplication of Duration and ElectricalConductance, which results in a ElectricalCapacitance scalar.
final ElectricalInductance	multiply(ElectricalResistance v)	Calculate the multiplication of Duration and ElectricalResistance, which results in a ElectricalInductance scalar.
final ElectricCharge	multiply(ElectricCurrent v)	Calculate the multiplication of Duration and ElectricCurrent, which results in a ElectricCharge scalar.
final MagneticFlux	multiply(ElectricPotential v)	Calculate the multiplication of Duration and ElectricPotential, which results in a MagneticFlux scalar.
final Mass	multiply(FlowMass v)	Calculate the multiplication of Duration and FlowMass, which results in a Mass scalar.
final Volume	multiply(FlowVolume v)	Calculate the multiplication of Duration and FlowVolume, which results in a Volume scalar.
final Energy	multiply(Power v)	Calculate the multiplication of Duration and Power, which results in a Energy scalar.
final Length	multiply(Speed v)	Calculate the multiplication of Duration and Speed, which results in a Length scalar.
static Duration	of(double value, String unitString)	Returns a Duration based on a value and the textual representation of the unit, which can be localized.
static Duration	ofSi(double si)	Return a Duration instance based on an SI value.
Frequency	reciprocal()	Return the reciprocal of this quantity (1/q).
SIUnit	siUnit()	Return the SI unit of this quantity.
static Duration	valueOf(String text)	Returns a Duration representation of a textual representation of a value with a unit.

Methods inherited from class org.djunits.quantity.def.Quantity

abs, add, as, compareTo, divide, doubleValue, eq, eq0, equals, floatValue, format, format, ge, ge0, getDisplayUnit, getInUnit, getInUnit, getName, gt, gt0, hashCode, instantiate, interpolate, intValue, isRelative, le, le0, longValue, lt, lt0, max, mean, min, multiply, ne, ne0, negate, of, product, scaleBy, setDisplayUnit, si, subtract, sum, toDisplayString, toDisplayString, toString, toString, toString, toString, toStringSIPrefixed, toStringSIPrefixed, toTextualString, toTextualString, valueOf

Methods inherited from class java.lang.Number

byteValue, shortValue

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.djunits.value.Scalable

divideBy

Methods inherited from interface org.djunits.value.Value

isAbsolute, setDisplayUnit

Field Details

ZERO

public static final Duration ZERO

Constant with value zero.

ONE

public static final Duration ONE

Constant with value one.

NaN

public static final Duration NaN

Constant with value NaN.

POSITIVE_INFINITY

public static final Duration POSITIVE_INFINITY

Constant with value POSITIVE_INFINITY.

NEGATIVE_INFINITY

public static final Duration NEGATIVE_INFINITY

Constant with value NEGATIVE_INFINITY.

POS_MAXVALUE

public static final Duration POS_MAXVALUE

Constant with value MAX_VALUE.

NEG_MAXVALUE

public static final Duration NEG_MAXVALUE

Constant with value -MAX_VALUE.

Constructor Details

Duration

public Duration(double value,
 Duration.Unit unit)

Instantiate a Duration quantity with a unit.

Parameters:

value - the value, expressed in the unit

unit - the unit in which the value is expressed

Duration

public Duration(double value,
 String abbreviation)

Instantiate a Duration quantity with a unit, expressed as a String.

Parameters:

value - the value, expressed in the unit

abbreviation - the String abbreviation of the unit in which the value is expressed

Duration

public Duration(Duration value)

Construct Duration quantity.

Parameters:

value - Scalar from which to construct this instance

Method Details

ofSi

public static Duration ofSi(double si)

Return a Duration instance based on an SI value.

Parameters:

si - the si value

Returns:

the Duration instance based on an SI value

instantiate

public Duration instantiate(double si)

Description copied from class: Quantity

Instantiate a quantity with an SI or base value.

Specified by:

instantiate in class Quantity<Duration,Duration.Unit>

Parameters:

si - the value expressed in the base (SI) unit

Returns:

a quantity with the given SI-value and base (SI) unit

siUnit

public SIUnit siUnit()

Description copied from class: Quantity

Return the SI unit of this quantity.

Overrides:

siUnit in class Quantity<Duration,Duration.Unit>

Returns:

the SI unit of this quantity

valueOf

public static Duration valueOf(String text)

Returns a Duration representation of a textual representation of a value with a unit. The String representation that can be parsed is the double value in the unit, followed by a localized or English abbreviation of the unit. Spaces are allowed, but not required, between the value and the unit.

Parameters:

text - the textual representation to parse into a Duration

Returns:

the Scalar representation of the value in its unit

Throws:

IllegalArgumentException - when the text cannot be parsed

NullPointerException - when the text argument is null

of

public static Duration of(double value,
 String unitString)

Returns a Duration based on a value and the textual representation of the unit, which can be localized.

Parameters:

value - the value to use

unitString - the textual representation of the unit

Returns:

the Scalar representation of the value in its unit

Throws:

IllegalArgumentException - when the unit cannot be parsed or is incorrect

NullPointerException - when the unitString argument is null

add

public final Time add(Time time)

Add an (absolute) time to this duration, and return a time. The unit of the return value will be the unit of this duration, and the reference of the return value will be the reference belonging to the given time. R.add(A) = unit of R and reference value of A.

Parameters:

time - the absolute time to add

Returns:

the absolute time plus this duration

divide

public final Dimensionless divide(Duration v)

Calculate the division of Duration and Duration, which results in a Dimensionless quantity.

Parameters:

v - quantity

Returns:

quantity as a division of Duration and Duration

multiply

public final ElectricCharge multiply(ElectricCurrent v)

Calculate the multiplication of Duration and ElectricCurrent, which results in a ElectricCharge scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and ElectricCurrent

multiply

public final Mass multiply(FlowMass v)

Calculate the multiplication of Duration and FlowMass, which results in a Mass scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and FlowMass

multiply

public final Volume multiply(FlowVolume v)

Calculate the multiplication of Duration and FlowVolume, which results in a Volume scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and FlowVolume

multiply

public final Speed multiply(Acceleration v)

Calculate the multiplication of Duration and Acceleration, which results in a Speed scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and Acceleration

multiply

public final Energy multiply(Power v)

Calculate the multiplication of Duration and Power, which results in a Energy scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and Power

multiply

public final Length multiply(Speed v)

Calculate the multiplication of Duration and Speed, which results in a Length scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and Speed

multiply

public final MagneticFlux multiply(ElectricPotential v)

Calculate the multiplication of Duration and ElectricPotential, which results in a MagneticFlux scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and ElectricPotential

multiply

public final ElectricalInductance multiply(ElectricalResistance v)

Calculate the multiplication of Duration and ElectricalResistance, which results in a ElectricalInductance scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and ElectricalResistance

multiply

public final ElectricalCapacitance multiply(ElectricalConductance v)

Calculate the multiplication of Duration and ElectricalConductance, which results in a ElectricalCapacitance scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and ElectricalConductance

multiply

public final Angle multiply(AngularVelocity v)

Calculate the multiplication of Duration and AngularVelocity, which results in a Angle scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and AngularVelocity

multiply

public final AngularVelocity multiply(AngularAcceleration v)

Calculate the multiplication of Duration and AngularAcceleration, which results in a AngularVelocity scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Duration and AngularAcceleration

reciprocal

public Frequency reciprocal()

Description copied from class: Quantity

Return the reciprocal of this quantity (1/q).

Overrides:

reciprocal in class Quantity<Duration,Duration.Unit>

Returns:

the reciprocal of this quantity, with the correct SI units