compact1, compact2, compact3

java.time.chrono

Interface ChronoPeriod

All Superinterfaces:

TemporalAmount

所有已知实现类：

Period

public interface ChronoPeriod
extends TemporalAmount

一个基于日期的时间量，如“3年，4个月和5天”，在一个任意的年代，用于先进的全球化用例。

此接口模型在日历系统中的日期为基础的时间量。虽然大多数日历系统使用年，月和日，一些不。因此，该接口可单独在一组支持单位，由Chronology定义的术语。支持单位设置固定为一个给定的年表。所支持的单位的数量可以设置为零。

该期间被建模为一个有向的时间量，这意味着该期间的各个部分可能是负的。

实现要求：

此接口必须小心地执行，以确保其他类正确操作。所有的实现可以被实例化必须是最终的，不变的，线程安全的。子类应该是可串行化的可能。

从以下版本开始：

一点八

方法摘要

Modifier and Type	Method and Description
Temporal	addTo(Temporal temporal) 将此时间添加到指定的时间对象。
static ChronoPeriod	between(ChronoLocalDate startDateInclusive, ChronoLocalDate endDateExclusive) 获得了由两个日期之间的时间量 ChronoPeriod。
boolean	equals(Object obj) 检查这一时期是否等于另一个时期，包括年代。
long	get(TemporalUnit unit) 获取所请求的单元的值。
Chronology	getChronology() 获取定义支持单位的意义的时间顺序。
List<TemporalUnit>	getUnits() 获取此期间所支持的单位集。
int	hashCode() 此期间的哈希代码。
default boolean	isNegative() 检查此期间的任何支持的单位是否为负。
default boolean	isZero() 检查此期间的所有支持的单位是否为零。
ChronoPeriod	minus(TemporalAmount amountToSubtract) 返回此期间的一个副本，与指定的周期减去。
ChronoPeriod	multipliedBy(int scalar) 返回一个新的实例，在这个周期中的每一个数量乘以指定的标量。
default ChronoPeriod	negated() 在这期间的每一笔收益的一个新实例否定。
ChronoPeriod	normalized() 返回此期间的副本与各单位归一化的金额。
ChronoPeriod	plus(TemporalAmount amountToAdd) 返回此期间的副本，添加指定的周期。
Temporal	subtractFrom(Temporal temporal) 从指定的对象减去这段时间。
String	toString() 输出成为这一时期的 String。

方法详细信息

between

static ChronoPeriod between(ChronoLocalDate startDateInclusive,
                            ChronoLocalDate endDateExclusive)

获得了由两个日期之间的时间量 ChronoPeriod。

开始日期包括在内，但结束日期不是。期间的计算使用ChronoLocalDate.until(ChronoLocalDate)。因此，计算是特定年代。

使用第一次日期的年代。第二次约会的年代被忽略，在计算开始之前，将日期转换为目标的时间顺序系统。

这种方法的结果可以是一个负周期，如果结束之前开始。在大多数情况下，在每个支持的字段中的正/负符号将是相同的。

参数

startDateInclusive的开始日期，包容，明确计算的年表，不空

endDateExclusive -结束日期，独家的，在任何年代，不空

结果

这个日期和结束日期之间的期间，而不是空

另请参见：

ChronoLocalDate.until(ChronoLocalDate)

get

long get(TemporalUnit unit)

获取所请求的单元的值。

所支持的单位是特定年代。他们通常会YEARS，MONTHS和DAYS。请求支持的单位将抛出一个异常。

Specified by:

get 接口 TemporalAmount

参数

unit -其中 TemporalUnit返回值

结果

单位的长值

异常

DateTimeException如果单位不支持

UnsupportedTemporalTypeException如果单位不支持

getUnits

List<TemporalUnit> getUnits()

获取此期间所支持的单位集。

所支持的单位是特定年代。他们通常会YEARS，MONTHS和DAYS。他们是从最大到最小的订单。

这套可结合使用get(TemporalUnit)访问期间整个国家。

Specified by:

getUnits 接口 TemporalAmount

结果

包含支持的单位的列表，而不是空的

getChronology

Chronology getChronology()

获取定义支持单位的意义的时间顺序。

该时期是由年代定义的。它控制支持单位和限制加/减到相同的情况下ChronoLocalDate年表。

结果

定义期间的年代，而不是空的

isZero

default boolean isZero()

检查此期间的所有支持的单位是否为零。

结果

如果这段时间为零的话，则为

isNegative

default boolean isNegative()

检查此期间的任何支持的单位是否为负。

结果

如果这一时期的任何单位是否定的

plus

ChronoPeriod plus(TemporalAmount amountToAdd)

返回此期间的副本，添加指定的周期。

如果指定的量是一个ChronoPeriod就必须有相同的时间为这段。实现可以选择接受或拒绝其他TemporalAmount实现。

此实例是不可变的，不受此方法调用的影响。

参数

amountToAdd期-添加，不为空

结果

一个 ChronoPeriod基于这段时期的要求，不为空

异常

ArithmeticException如果数值溢出时

minus

ChronoPeriod minus(TemporalAmount amountToSubtract)

返回此期间的一个副本，与指定的周期减去。

如果指定的量是一个ChronoPeriod就必须有相同的时间为这段。实现可以选择接受或拒绝其他TemporalAmount实现。

此实例是不可变的，不受此方法调用的影响。

参数

amountToSubtract -期减，不为空

结果

一个 ChronoPeriod基于这段时期的要求减去，不空

异常

ArithmeticException如果数值溢出时

multipliedBy

ChronoPeriod multipliedBy(int scalar)

返回一个新的实例，在这个周期中的每一个数量乘以指定的标量。

这将返回一个每个支持的单位单独相乘的周期。例如，一个“2年，- 3个月和4天”乘以3将返回“6年，- 9个月和12天”。没有进行正常化。

参数

scalar -标量乘，不为空

结果

一个 ChronoPeriod基于本期金额乘以标量，不空

异常

ArithmeticException如果数值溢出时

negated

default ChronoPeriod negated()

在这期间的每一笔收益的一个新实例否定。

这将返回一个与支持的每个单元单独否定期。例如，一个时期的“2年，3个月4天”将否定“2年，3个月和4天”。没有进行正常化。

结果

一个 ChronoPeriod基于这一时期的大量否定，不为空

异常

ArithmeticException如果数值溢出时，只发生如果一个单位有价值 Long.MIN_VALUE

normalized

ChronoPeriod normalized()

返回此期间的副本与各单位归一化的金额。

正常化的过程是特定于每个日历系统。例如，在国际标准化组织日历系统中，这些年和几个月是正常化的，但天是不正常的，这样的“15个月”将被归为“1年和3个月”。

此实例是不可变的，不受此方法调用的影响。

结果

一个 ChronoPeriod基于本期金额每单元标准化，不为空

异常

ArithmeticException如果数值溢出时

addTo

Temporal addTo(Temporal temporal)

将此时间添加到指定的时间对象。

这将返回一个相同可观察类型的时间对象，作为此期间添加的输入。

在大多数情况下，更清晰的用Temporal.plus(TemporalAmount)反向调用模式。

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

指定的时间必须有相同的时间顺序为这一时期。这将返回一个时间与非零支持单位添加。

此实例是不可变的，不受此方法调用的影响。

Specified by:

addTo 接口 TemporalAmount

参数

temporal -调整时间的对象，不为空

结果

同一类型的对象与所作的调整，而不是空

异常

DateTimeException如果无法添加

ArithmeticException如果数值溢出时

subtractFrom

Temporal subtractFrom(Temporal temporal)

从指定的对象减去这段时间。

这将返回一个相同可观察类型的时间对象，作为此期间减去的输入。

在大多数情况下，更清晰的用Temporal.minus(TemporalAmount)反向调用模式。

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

指定的时间必须有相同的时间顺序为这一时期。这将返回一个时间与非零支持单位减去。

此实例是不可变的，不受此方法调用的影响。

Specified by:

subtractFrom 接口 TemporalAmount

参数

temporal -调整时间的对象，不为空

结果

同一类型的对象与所作的调整，而不是空

异常

DateTimeException如果不能减

ArithmeticException如果数值溢出时

equals

boolean equals(Object obj)

检查这一时期是否等于另一个时期，包括年代。

比较这一时期与另一个确保类型，每一个数量和年代是相同的。请注意，这意味着一个“15个月”的期限不等于一个“1年和3个月”的时期。

重写：

equals 方法重写，继承类 Object

参数

obj -检查对象，空返回false

结果

如果这是等于另一个时期

另请参见：

Object.hashCode()， HashMap

hashCode

int hashCode()

此期间的哈希代码。

重写：

hashCode 方法重写，继承类 Object

结果

一个合适的哈希代码

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

toString

String toString()

输出成为这一时期的 String。

输出将包括期间金额和时间。

重写：

toString 方法重写，继承类 Object

结果

这个期间的字符串表示，而不是空