compact1, compact2, compact3

java.time.temporal

Interface TemporalAmount

All Known Subinterfaces:

ChronoPeriod

所有已知实现类：

Duration， Period

public interface TemporalAmount

框架级接口定义一个时间量，如“6小时”、“8天”或“2年3个月”。

这是大量的时间的基本接口类型。一个数量是不同的日期或时间的一天，它不与任何特定的点上的时间线。

量可以认为是一个Map的TemporalUnit到long，通过getUnits()和get(TemporalUnit)暴露。一个简单的情况可能有一个单一的单位值对，如“6小时”。一个更复杂的情况下，可能有多个单位值对，如“7年，3个月和5天”。

有两种常见的实现方式。Period是实现基于存储日期，年，月，日。Duration是一个基于时间的实现，存储秒和纳秒，但提供了一些访问使用其他基于持续时间的单位为分钟，小时和24小时天固定。

此接口是一个框架级接口，不应该被广泛应用于应用程序代码中。相反，应用程序应该创造和传递的具体类型的实例，如Period和Duration。

实现要求：

这个接口的地方实现的易变性，没有限制，但是不强烈推荐。

从以下版本开始：

一点八

方法摘要

Modifier and Type	Method and Description
Temporal	addTo(Temporal temporal) 添加到指定的时间对象。
long	get(TemporalUnit unit) 返回所请求的单位的值。
List<TemporalUnit>	getUnits() 返回唯一确定这个TemporalAmount的价值单位名单。
Temporal	subtractFrom(Temporal temporal) 从指定的时空对象中减去这个对象。

方法详细信息

get

long get(TemporalUnit unit)

返回所请求的单位的值。从单位返回 getUnits()唯一确定的 TemporalAmount价值。值必须返回列的 getUnits每个单元。

实现要求：

实现可能宣布不上市的 getUnits()单位支持。通常，实现要定义额外的单位作为开发商的方便转换。

参数

unit -其中 TemporalUnit返回值

结果

单位的长值

异常

DateTimeException如果单位不能得到一个值

UnsupportedTemporalTypeException -如果 unit不支持

getUnits

List<TemporalUnit> getUnits()

返回唯一确定这个TemporalAmount的价值单位名单。对 TemporalUnits名单是由实现类定义。这份名单是当时 getUnits称为不可变的快照的单位。该单位是从最长的持续时间到单位的最短时间。

实现要求：

单位的列表完全和唯一表示对象的状态，而无遗漏，重叠或重复。单位是从最长的持续时间到最短。

结果

TemporalUnits列表不是空的；

addTo

Temporal addTo(Temporal temporal)

添加到指定的时间对象。

使用在实现类中封装的逻辑将金额添加到指定的时间对象中。

使用这种方法有两个等效的方法。首先是直接调用这个方法。二是用Temporal.plus(TemporalAmount)：

这两条线是等价的，但第二种方法是建议日期时间=量补充（日期）；日期时间=日期。+（加法）；

建议使用第二种方法， plus(TemporalAmount)，因为它是一个更清晰的读码。

实现要求：

执行必须以输入对象并添加到它。该实现定义了加法的逻辑，并负责记录该逻辑。它可以使用在任何时间 Temporal方法查询对象和执行加法。返回的对象必须具有相同的观察到的类型作为输入对象

输入对象不能被更改。相反，必须返回原始的调整副本。这提供了等效，为不变的和可变的时空对象的安全行为。

输入的时间对象可能是在其他的日历系统中。实现可以选择的文件与其他日历系统兼容，或拒绝非异时空对象的querying the chronology。

这种方法可以从多个线程中调用。当调用时它必须是线程安全的。

参数

temporal -添加量对时间的对象，不为空

结果

同一可观察到的类型的对象，而不是空的

异常

DateTimeException如果无法添加

ArithmeticException如果数值溢出时

subtractFrom

Temporal subtractFrom(Temporal temporal)

从指定的时空对象中减去这个对象。

从指定的时间对象使用逻辑封装在实现类中减去金额。

使用这种方法有两个等效的方法。首先是直接调用这个方法。二是用Temporal.minus(TemporalAmount)：

这两条线是等价的，但第二种方法是建议日期时间=金额减去（日期）；日期时间=日期减去（量）；

建议使用第二种方法， minus(TemporalAmount)，因为它是一个更清晰的读码。

实现要求：

执行必须采取输入对象，并从中减去。该实现定义了减法的逻辑，并负责记录该逻辑。它可以使用在任何时间 Temporal方法查询对象和执行减法。返回的对象必须具有相同的观察到的类型作为输入对象

输入对象不能被更改。相反，必须返回原始的调整副本。这提供了等效，为不变的和可变的时空对象的安全行为。

输入的时间对象可能是在其他的日历系统中。实现可以选择的文件与其他日历系统兼容，或拒绝非异时空对象的querying the chronology。

这种方法可以从多个线程中调用。当调用时它必须是线程安全的。

参数

temporal -扣除从时态对象，不为空

结果

相同可观察到的类型的对象，而不是空的

异常

DateTimeException如果不能减

ArithmeticException如果数值溢出时