Package java.time.chrono

除了默认的标准以外的日历系统的通用的。

See: 描述

接口摘要

接口	描述
ChronoLocalDate	一个没有时间的天或时间区的日期，在一个任意的年代，用于先进的全球化用例。
ChronoLocalDateTime<D extends ChronoLocalDate>	一个没有时间区的日期时间，在一个任意的年代，用于先进的全球化用例。
Chronology	用于组织和识别日期的日历系统。
ChronoPeriod	一个基于日期的时间量，如“3年，4个月和5天”，在一个任意的年代，用于先进的全球化用例。
ChronoZonedDateTime<D extends ChronoLocalDate>	一个时间区的日期时间，在一个任意的年代，用于先进的全球化用例。
Era	一个时间线的时代。

类摘要

类	描述
AbstractChronology	用于组织和识别日期的日历系统的一个抽象实现。
HijrahChronology	迁徙的日历是农历支持伊斯兰日历。
HijrahDate	在迁徙的日历系统日期。
IsoChronology	等日历系统。
JapaneseChronology	日本帝国日历系统。
JapaneseDate	日本帝国日历系统中的日期。
JapaneseEra	日本帝国日历系统的一个时代。
MinguoChronology	民国的日历系统。
MinguoDate	在民国历法日期。
ThaiBuddhistChronology	泰国佛教日历系统。
ThaiBuddhistDate	泰国佛教日历系统中的日期。

枚举摘要

Enum	描述
HijrahEra	在迁徙的日历系统时代。
IsoEra	在国际标准体系中的一个时代。
MinguoEra	在民国时代的日历系统。
ThaiBuddhistEra	泰国佛教日历系统的一个时代。

Package java.time.chrono Description

除了默认的标准以外的日历系统的通用的。

主要的API是基于定义ISO-8601日历系统。然而，有其他的日历系统，这个包为他们提供了基本的支持。备用日历在java.time.chrono包提供。

日历系统是由Chronology接口定义的，而在一个日历系统的日期是由ChronoLocalDate接口定义。

它的目的是应用程序使用主要的应用程序，只要有可能，包括代码来读取和写入从一个持久性的数据存储，如数据库，并通过网络发送日期和时间。“时辰”类，然后在用户接口层来处理局部输入/输出。看到一个完整的讨论问题ChronoLocalDate。

在应用程序中使用非等异日历系统引入了显著的额外复杂度。确保在ChronoLocalDate的警告和建议已在与“时空”的接口读取。

支持的日历系统包括：

• Hijrah calendar
• Japanese calendar
• Minguo calendar
• Thai Buddhist calendar

例子

这个例子列出了今天所有可用的日历的日期。

/枚举可用的日历的列表，并为每个可用的日历打印今天的日期。集
 
     
     
     
   
     
   <年表>
    
      
    
      
      
      
   Chronos = getavailablechronologies()年表；对于（年表时辰：Chronos）{chronolocaldate日期= datenow()时辰；系统。了printf（“%岁：%s”，时辰。getid()，日期。tostring()）；}
 
     
     
     
   
     
   

此示例在一个命名的非日历系统中创建和使用日期。

/打印泰国佛教日期chronolocaldate说话=年表，（“thaibuddhist”）。datenow()；int天=说话。得到（chronofield。day_of_month）；在道琼斯指数=说话。得到（chronofield。day_of_week）；月=说话。得到（chronofield。month_of_year）；int year =说话。得到（chronofield。年）；系统。了printf（“今天是%s %s %d %s - % N”，说话。getchronology()。getid()，道琼斯指数，日，月，年）；/打印今天的日期和一年的最后一天，泰国佛教日历。chronolocaldate第一=说话与（chronofield.day_of_month，1）。与（chronofield.month_of_year，1）；chronolocaldate最后=第一。再加上（1，chronounit。年）-（1，ChronoUnit。天）；系统。了printf（“%s”：第一年：%s；年末：%s”，最后，getid() getchronology()，首先，最后一个）；

此示例创建并使用一个日期在一个特定的thaibuddhist日历系统。

/打印泰国佛教日期thaibuddhistdate说话= thaibuddhistdate。now()；int天=说话。得到（chronofield。day_of_month）；在道琼斯指数=说话。得到（chronofield。day_of_week）；月=说话。得到（chronofield。month_of_year）；int year =说话。得到（chronofield。年）；系统。了printf（“今天是%s %s %d %s - % N”，说话。getchronology()。getid()，道琼斯指数，日，月，年）；/打印今天的日期和一年的最后一天，泰国佛教日历。thaibuddhistdate第一=说话与（chronofield.day_of_month，1）。与（chronofield.month_of_year，1）；thaibuddhistdate最后=第一。再加上（1，chronounit。年）-（1，ChronoUnit。天）；系统。了printf（“%s”：第一年：%s；年末：%s”，最后，getid() getchronology()，首先，最后一个）；

包装规格

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

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

从以下版本开始：

JDK1.8