compact3

Package java.time.temporal

访问日期和时间的应用领域和单位，时间和日期的调节。

See: 描述

接口摘要

接口	描述
Temporal	框架层接口定义读写访问时间的对象，如日期、时间、抵消或它们的一些组合。
TemporalAccessor	框架级接口定义一个时间对象的只读访问，如日期、时间、偏移或这些组合的一些组合。
TemporalAdjuster	调整时态对象的策略。
TemporalAmount	框架级接口定义一个时间量，如“6小时”、“8天”或“2年3个月”。
TemporalField	日期时间的字段，如一年或一小时的一个小时。
TemporalQuery<R>	用于查询时态对象的策略。
TemporalUnit	日期时间的单位，如几天或几个小时。

类摘要

类	描述
IsoFields	领域和单位具体到ISO-8601的日历系统，包括年、周年季度的基础。
JulianFields	提供访问Julian Days的日期字段集。
TemporalAdjusters	常见的和有用的temporaladjusters。
TemporalQueries	TemporalQuery共同实现的。
ValueRange	日期时间字段的有效值的范围。
WeekFields	每周一周，月周和一周的一周的局部定义。

枚举摘要

Enum	描述
ChronoField	一组标准的字段。
ChronoUnit	一套标准的日期期间单位。

异常摘要

异常	描述
UnsupportedTemporalTypeException	unsupportedtemporaltypeexception表明chronofield或chronounit不是一个时间类支持。

Package java.time.temporal Description

访问日期和时间的应用领域和单位，时间和日期的调节。

此包在基包中扩展，以提供更强大的用例的附加功能。支持包括：

• 日期时间单位，如年、月、日、小时
• 日期时间的字段，如一年中的一个月，一周或一小时的一天
• 日期时间调整功能
• 不同定义的周

领域和单位

日期和时间在字段和单位表示。一个单位是用来衡量一个时间量，如几年，几天或几分钟。各单位实施TemporalUnit。知名单位的设置是指在ChronoUnit，如DAYS。单元接口被设计为允许应用程序定义的单位。

字段是用来表示较大日期时间的一部分，如年、年月份或第二个分钟。所有领域实现TemporalField。众所周知的一组字段中定义ChronoField，如HOUR_OF_DAY。额外的字段定义的JulianFields，WeekFields和IsoFields。字段接口被设计为允许应用程序定义的字段。

此包提供了允许以一般方式最适合框架访问的日期和时间的单位和字段的工具。Temporal提供日期时间类型，支持领域的抽象。它的方法支持获取字段的值，创建一个字段修改的值的新的日期时间，并查询额外的信息，通常用于提取偏移或时区。

在应用程序代码中的字段的一个使用是检索没有方便的方法的字段。例如，得到月天是很常见的，有一种方法叫做getDayOfMonth() LocalDate。然而对于更多的不寻常的领域，它是必要的，使用该字段。例如，date.get(ChronoField.ALIGNED_WEEK_OF_MONTH)。字段还提供了对有效值范围的访问。

调整和查询

日期时间问题空间的一个关键部分是调整日期到一个新的，相关的价值，如“月的最后一天”，或“下星期三”。这些被建模为调整基准日期时间的函数。该功能的实现和操作Temporal TemporalAdjuster。一套通用的功能提供了TemporalAdjusters。例如，找到一个星期前发生的一个给定的日期，TemporalAdjusters.next(DayOfWeek)后使用，如date.with(next(MONDAY))。应用程序还可以通过实施TemporalAdjuster定义调节器。

相对时间TemporalAmount界面模型数量。

除了调整日期时间，提供一个接口，使通过TemporalQuery查询，查询界面最常见的实现方法参考。在专业课的from(TemporalAccessor)方法都可以使用，如LocalDate::from或Month::from。进一步的实现提供了TemporalQueries作为静态方法。应用程序还可以通过实施TemporalQuery定义查询。

周

不同的地区有不同的定义的周。例如，在欧洲，一周通常是在星期一开始的，而在美国，它是在星期日开始的。WeekFields类模型的区别。

的的的日历系统定义了一个额外的一周为基础的分工。这定义了一年的基础上整个星期一至星期一周。这是仿照在IsoFields。

包装规格

除非另有说明，通过空参数的构造函数或方法的任何类或接口在这个包会导致NullPointerException被。Javadoc“@参数”的定义是用于概括无效行为。“@投NullPointerException”是没有明确的记录在每一个方法。

所有的计算应检查数值溢出和扔一个ArithmeticException或DateTimeException。

从以下版本开始：

JDK1.8