Package java.time.chrono

除默认ISO之外的日历系统的通用API。

See: 描述

接口摘要

接口	描述
ChronoLocalDate	一个无时间，无时间的日期，用于任意年龄，用于高级全球化用例。
ChronoLocalDateTime<D extends ChronoLocalDate>	在任意年代没有时区的日期时间，用于高级全球化用例。
Chronology	用于组织和识别日期的日历系统。
ChronoPeriod	基于日期的时间，例如任意年代的“3年，4个月和5天”，旨在用于高级全球化用例。
ChronoZonedDateTime<D extends ChronoLocalDate>	具有时间序列的日期时间，以任意时间顺序排列，旨在用于高级全球化用例。
Era	时代的时代。

类摘要

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

枚举摘要

Enum	描述
HijrahEra	Hijrah日历系统中的一个时代。
IsoEra	ISO日历系统中的一个时代。
MinguoEra	国际日历系统中的一个时代。
ThaiBuddhistEra	泰国佛教日历系统的时代。

Package java.time.chrono Description

除默认ISO之外的日历系统的通用API。

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

日历系统由Chronology界面定义，而日历系统中的日期由ChronoLocalDate界面定义。

意图是应用程序尽可能使用主API，包括从持久数据存储（如数据库）读取和写入代码，以及通过网络发送日期和时间。 然后在用户界面级别使用“计时”类来处理本地化的输入/输出。 有关问题的全面讨论，请参阅ChronoLocalDate 。

在应用程序中使用非ISO日历系统会引起显着的额外复杂性。 确保中的警告和建议ChronoLocalDate已经与“计时”接口之前，请先阅读。

支持的日历系统包括：

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

例

此示例列出了所有可用日历的今天日期。

  // Enumerate the list of available calendars and print todays date for each.
       Set<Chronology> chronos = Chronology.getAvailableChronologies();
       for (Chronology chrono : chronos) {
           ChronoLocalDate date = chrono.dateNow();
           System.out.printf("   %20s: %s%n", chrono.getId(), date.toString());
       } 

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

  // Print the Thai Buddhist date
       ChronoLocalDate now1 = Chronology.of("ThaiBuddhist").dateNow();
       int day = now1.get(ChronoField.DAY_OF_MONTH);
       int dow = now1.get(ChronoField.DAY_OF_WEEK);
       int month = now1.get(ChronoField.MONTH_OF_YEAR);
       int year = now1.get(ChronoField.YEAR);
       System.out.printf("  Today is %s %s %d-%s-%d%n", now1.getChronology().getId(),
                 dow, day, month, year);
   // Print today's date and the last day of the year for the Thai Buddhist Calendar.
       ChronoLocalDate first = now1
                 .with(ChronoField.DAY_OF_MONTH, 1)
                 .with(ChronoField.MONTH_OF_YEAR, 1);
       ChronoLocalDate last = first
                 .plus(1, ChronoUnit.YEARS)
                 .minus(1, ChronoUnit.DAYS);
       System.out.printf("  %s: 1st of year: %s; end of year: %s%n", last.getChronology().getId(),
                 first, last); 

此示例创建并使用特定ThaiBuddhist日历系统中的日期。

  // Print the Thai Buddhist date
       ThaiBuddhistDate now1 = ThaiBuddhistDate.now();
       int day = now1.get(ChronoField.DAY_OF_MONTH);
       int dow = now1.get(ChronoField.DAY_OF_WEEK);
       int month = now1.get(ChronoField.MONTH_OF_YEAR);
       int year = now1.get(ChronoField.YEAR);
       System.out.printf("  Today is %s %s %d-%s-%d%n", now1.getChronology().getId(),
                 dow, day, month, year);

   // Print today's date and the last day of the year for the Thai Buddhist Calendar.
       ThaiBuddhistDate first = now1
                 .with(ChronoField.DAY_OF_MONTH, 1)
                 .with(ChronoField.MONTH_OF_YEAR, 1);
       ThaiBuddhistDate last = first
                 .plus(1, ChronoUnit.YEARS)
                 .minus(1, ChronoUnit.DAYS);
       System.out.printf("  %s: 1st of year: %s; end of year: %s%n", last.getChronology().getId(),
                 first, last); 

包装规格

除非另有说明，否则在此包中的任何类或接口中将null参数传递给构造函数或方法将导致抛出NullPointerException 。 Javadoc“@param”定义用于总结空行为。 “@throws NullPointerException ”没有在每个方法中明确记录。

所有计算应检查数字溢出并抛出ArithmeticException或DateTimeException 。

从以下版本开始：

JDK1.8