
- 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