- java.time - Home
- java.time - Clock
- java.time - Duration
- java.time - Instant
- java.time - LocalDate
- java.time - LocalDateTime
- java.time - LocalTime
- java.time - MonthDay
- java.time - OffsetDateTime
- java.time - OffsetTime
- java.time - Period
- java.time - Year
- java.time - YearMonth
- java.time - ZonedDateTime
- java.time - ZoneId
- java.time - ZoneOffset
- java.time Package Enums
- java.time - Month
- java.time Useful Resources
- java.time - Discussion
java.time.Duration Class
Introduction
The java.time.Duration class models a quantity or amount of time in terms of seconds and nanoseconds. It can be accessed using other duration-based units, such as minutes and hours.
Class declaration
Following is the declaration for java.time.Duration class −
public final class Duration
extends Object
implements TemporalAmount, Comparable<Duration>, Serializable
Field
Following are the fields for java.time.Duration class −
static Duration ZERO − Constant for a duration of zero.
Class methods
| Sr.No. | Method & Description |
|---|---|
| 1 |
Duration abs()
Returns a copy of this duration with a positive length. |
| 2 |
Temporal addTo(Temporal temporal)
Adds this duration to the specified temporal object. |
| 3 |
static Duration between(Temporal startInclusive, Temporal endExclusive)
Obtains a Duration representing the duration between two temporal objects. |
| 4 |
int compareTo(Duration otherDuration)
Compares this duration to the specified Duration. |
| 5 |
Duration dividedBy(long divisor)
Returns a copy of this duration divided by the specified value. |
| 6 |
boolean equals(Object otherDuration)
Checks if this duration is equal to the specified Duration. |
| 7 |
static Duratio from(TemporalAmount amount)
Obtains an instance of Duration from a temporal amount. |
| 8 |
long get(TemporalUnit unit)
Gets the value of the requested unit. |
| 9 |
int getNano()
Gets the number of nanoseconds within the second in this duration. |
| 10 |
long getSeconds()
Gets the number of seconds in this duration. |
| 11 |
List<TemporalUnit> getUnits()
Gets the set of units supported by this duration. |
| 12 |
int hashCode()
A hash code for this duration. |
| 13 |
boolean isNegative()
Checks if this duration is negative, excluding zero. |
| 14 |
boolean isZero()
Checks if this duration is zero length. |
| 15 |
Duration minus(Duration duration)
Returns a copy of this duration with the specified duration subtracted. |
| 16 |
Duration minus(long amountToSubtract, TemporalUnit unit)
Returns a copy of this duration with the specified duration subtracted. |
| 17 |
Duration minusDays(long daysToSubtract)
Returns a copy of this duration with the specified duration in standard 24 hour days subtracted. |
| 18 |
Duration minusHours(long hoursToSubtract)
Returns a copy of this duration with the specified duration in hours subtracted. |
| 19 |
Duration minusMillis(long millisToSubtract)
Returns a copy of this duration with the specified duration in milliseconds subtracted. |
| 20 |
Duration minusMinutes(long minutesToSubtract)
Returns a copy of this duration with the specified duration in minutes subtracted. |
| 21 |
Duration minusNanos(long nanosToSubtract)
Returns a copy of this duration with the specified duration in nanoseconds subtracted. |
| 22 |
Duration minusSeconds(long secondsToSubtract)
Returns a copy of this duration with the specified duration in seconds subtracted. |
| 23 |
Duration multipliedBy(long multiplicand)
Returns a copy of this duration multiplied by the scalar. |
| 24 |
Duration negated()
Returns a copy of this duration with the length negated. |
| 25 |
static Duration of(long amount, TemporalUnit unit)
Obtains a Duration representing an amount in the specified unit. |
| 26 |
static Duration ofDays(long days)
Obtains a Duration representing a number of standard 24 hour days. |
| 27 |
static Duration ofHours(long hours)
Obtains a Duration representing a number of standard hours. |
| 28 |
static Duration ofMillis(long millis)
Obtains a Duration representing a number of milliseconds. |
| 29 |
static Duration ofMinutes(long minutes)
Obtains a Duration representing a number of standard minutes. |
| 30 |
static Duration ofNanos(long nanos)
Obtains a Duration representing a number of nanoseconds. |
| 31 |
static Duration ofSeconds(long seconds)
Obtains a Duration representing a number of seconds. |
| 32 |
static Duration ofSeconds(long seconds, long nanoAdjustment)
Obtains a Duration representing a number of seconds and an adjustment in nanoseconds. |
| 33 |
static Duration parse(CharSequence text)
Obtains a Duration from a text string such as PnDTnHnMn.nS. |
| 34 |
Duration plus(Duration duration)
Returns a copy of this duration with the specified duration added. |
| 35 |
Duration plus(long amountToAdd, TemporalUnit unit)
Returns a copy of this duration with the specified duration added. |
| 36 |
Duration plusDays(long daysToAdd)
Returns a copy of this duration with the specified duration in standard 24 hour days added. |
| 37 |
Duration plusHours(long hoursToAdd)
Returns a copy of this duration with the specified duration in hours added. |
| 38 |
Duration plusMillis(long millisToAdd)
Returns a copy of this duration with the specified duration in milliseconds added. |
| 39 |
Duration plusMinutes(long minutesToAdd)
Returns a copy of this duration with the specified duration in minutes added. |
| 40 |
Duration plusNanos(long nanosToAdd)
Returns a copy of this duration with the specified duration in nanoseconds added. |
| 41 |
Duration plusSeconds(long secondsToAdd)
Returns a copy of this duration with the specified duration in seconds added. |
| 42 |
Temporal subtractFrom(Temporal temporal)
Subtracts this duration from the specified temporal object. |
| 43 |
long toDays()
Gets the number of days in this duration. |
| 44 |
long toHours()
Gets the number of hours in this duration. |
| 45 |
long toMillis()
Converts this duration to the total length in milliseconds. |
| 46 |
long toMinutes()
Gets the number of minutes in this duration. |
| 47 |
long toNanos()
Converts this duration to the total length in nanoseconds expressed as a long. |
| 48 |
String toString()
A string representation of this duration using ISO-8601 seconds based representation, such as PT8H6M12.345S. |
| 49 |
Duration withNanos(int nanoOfSecond)
Returns a copy of this duration with the specified nano-of-second. |
| 50 |
Duration withSeconds(long seconds)
Returns a copy of this duration with the specified amount of seconds. |
Methods inherited
This class inherits methods from the following classes −
- Java.lang.Object