| 接口 | 描述 |
|---|---|
| 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 |
泰国佛教日历系统的时代。
|
除默认ISO之外的日历系统的通用API。
主要API基于ISO-8601中定义的日历系统。 但是，还有其他日历系统，这个包提供了基本的支持。 备用日历在java.time.chrono包中提供。
日历系统由Chronology界面定义，而日历系统中的日期由ChronoLocalDate界面定义。
意图是应用程序尽可能使用主API，包括从持久数据存储（如数据库）读取和写入代码，以及通过网络发送日期和时间。 然后在用户界面级别使用“计时”类来处理本地化的输入/输出。 有关问题的全面讨论，请参阅ChronoLocalDate 。
在应用程序中使用非ISO日历系统会引起显着的额外复杂性。 确保中的警告和建议ChronoLocalDate已经与“计时”接口之前，请先阅读。
支持的日历系统包括：
此示例列出了所有可用日历的今天日期。
// 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 。