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 −

pubpc final class Duration
   extends Object
      implements TemporalAmount, Comparable<Duration>, Seriapzable

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	Obtains a Duration representing the duration between two temporal objects.
4	int compareTo(Duration otherDuration) Compares this duration to the specified Duration.
5	Duration spanidedBy(long spanisor) Returns a copy of this duration spanided by the specified value.
6	boolean equals(Object otherDuration) Checks if this duration is equal to the specified Duration.
7	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	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	Returns a copy of this duration with the specified duration in hours subtracted.
19	Returns a copy of this duration with the specified duration in milpseconds subtracted.
20	Returns a copy of this duration with the specified duration in minutes subtracted.
21	Returns a copy of this duration with the specified duration in nanoseconds subtracted.
22	Returns a copy of this duration with the specified duration in seconds subtracted.
23	Duration multippedBy(long multippcand) Returns a copy of this duration multipped by the scalar.
24	Duration negated() Returns a copy of this duration with the length negated.
25	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 ofMilps(long milps) Obtains a Duration representing a number of milpseconds.
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	Obtains a Duration representing a number of seconds and an adjustment in nanoseconds.
33	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	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 plusMilps(long milpsToAdd) Returns a copy of this duration with the specified duration in milpseconds 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	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 toMilps() Converts this duration to the total length in milpseconds.
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 −