Javatime 简明教程

java.time.Duration Class

Introduction

java.time.Duration 类根据秒和纳秒对时间或时间量进行建模。它可以使用其他基于持续时间的单位（如分钟和小时）访问。

Class declaration

以下是 java.time.Duration 类的声明：

public final class Duration
   extends Object
      implements TemporalAmount, Comparable<Duration>, Serializable

Field

以下是 java.time.Duration 类的字段：

static Duration ZERO −零持续时间常量。

Class methods

Sr.No.	Method & Description
1	Duration abs() 返回具有正长度的此持续时间的副本。
2	Temporal addTo(Temporal temporal) 将此持续时间添加到指定的时间对象。
3	static Duration between(Temporal startInclusive, Temporal endExclusive) 获取表示两个时间对象之间持续时间的持续时间。
4	int compareTo(Duration otherDuration) 将此持续时间与指定的持续时间进行比较。
5	Duration dividedBy(long divisor) 返回此持续时间除以指定值的副本。
6	boolean equals(Object otherDuration) 检查此持续时间是否等于指定的持续时间。
7	static Duratio from(TemporalAmount amount) 从时间量获取一个持续时间实例。
8	long get(TemporalUnit unit) 获取所请求单位的值。
9	int getNano() 获取该持续时间中以毫微秒为单位的秒数。
10	long getSeconds() 获取该持续时间中以秒为单位的秒数。
11	List<TemporalUnit> getUnits() 获取该持续时间支持的单位集合。
12	int hashCode() 该持续时间的哈希码。
13	boolean isNegative() 检查该持续时间是否为负，不包括零。
14	boolean isZero() 检查该持续时间是否为零长度。
15	Duration minus(Duration duration) 返回一个该持续时间在减去指定持续时间后的副本。
16	Duration minus(long amountToSubtract, TemporalUnit unit) 返回一个该持续时间在减去指定持续时间后的副本。
17	Duration minusDays(long daysToSubtract) 返回一个该持续时间在减去以 24 小时为标准天的指定持续时间后的副本。
18	Duration minusHours(long hoursToSubtract) 返回一个该持续时间在减去以小时为单位的指定持续时间后的副本。
19	Duration minusMillis(long millisToSubtract) 返回一个该持续时间在减去以毫秒为单位的指定持续时间后的副本。
20	Duration minusMinutes(long minutesToSubtract) 返回一个该持续时间在减去以分钟为单位的指定持续时间后的副本。
21	Duration minusNanos(long nanosToSubtract) 返回一个该持续时间在减去以纳秒为单位的指定持续时间后的副本。
22	Duration minusSeconds(long secondsToSubtract) 返回一个该持续时间在减去以秒为单位的指定持续时间后的副本。
23	Duration multipliedBy(long multiplicand) 返回一个该持续时间乘以标量后的副本。
24	Duration negated() 返回一个该持续时间的长度取相反数后的副本。
25	static Duration of(long amount, TemporalUnit unit) 获取一个代表指定单位中的数量的持续时间。
26	static Duration ofDays(long days) 获取一个代表标准 24 小时天数的持续时间。
27	static Duration ofHours(long hours) 获取一个代表标准小时数的持续时间。
28	static Duration ofMillis(long millis) 获取一个表示毫秒数的持续时间。
29	static Duration ofMinutes(long minutes) 获取一个表示标准分钟数的持续时间。
30	static Duration ofNanos(long nanos) 获取一个表示纳秒数的持续时间。
31	static Duration ofSeconds(long seconds) 获取一个表示几秒的持续时间。
32	static Duration ofSeconds(long seconds, long nanoAdjustment) 获取一个表示几秒和以纳秒为单位进行调整的持续时间。
33	static Duration parse(CharSequence text) 从文本字符串（例如 PnDTnHnMn.nS）获取一个持续时间。
34	Duration plus(Duration duration) 返回添加指定持续时间的此持续时间的副本。
35	Duration plus(long amountToAdd, TemporalUnit unit) 返回添加指定持续时间的此持续时间的副本。
36	Duration plusDays(long daysToAdd) 返回添加指定持续时间（以标准 24 小时天计）的此持续时间的副本。
37	Duration plusHours(long hoursToAdd) 返回添加指定持续时间（以小时计）的此持续时间的副本。
38	Duration plusMillis(long millisToAdd) 返回添加指定持续时间（以毫秒计）的此持续时间的副本。
39	Duration plusMinutes(long minutesToAdd) 返回添加指定持续时间（以分钟计）的此持续时间的副本。
40	Duration plusNanos(long nanosToAdd) 返回添加指定持续时间（以纳秒计）的此持续时间的副本。
41	Duration plusSeconds(long secondsToAdd) 返回添加指定持续时间（以秒计）的此持续时间的副本。
42	Temporal subtractFrom(Temporal temporal) 从此持续时间中减去指定的时间对象。
43	long toDays() 获取此持续时间中的天数。
44	long toHours() 获取此持续时间中的小时数。
45	long toMillis() 将此持续时间转换为以毫秒为单位的总长度。
46	long toMinutes() 获取此持续时间中的分钟数。
47	long toNanos() 将此时长转换为用一个长整型表示的以纳秒为单位的总长度。
48	String toString() 此时长的字符串表示形式使用基于 ISO-8601 秒的表示形式，例如 PT8H6M12.345S。
49	Duration withNanos(int nanoOfSecond) 返回带有指定纳秒的此时长的副本。
50	Duration withSeconds(long seconds) 返回带有指定秒数的此时长的副本。

Methods inherited

此类从以下类中继承方法：

Java.lang.Object