Package java.time.chrono

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

主API基于ISO-8601中定义的日历系统。 但是，还有其他日历系统，此软件包为它们提供基本支持。 java.time.chrono包中提供了备用日历。

日历系统由Chronology接口定义，而日历系统中的日期由ChronoLocalDate接口定义。

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

在应用程序中使用非ISO日历系统会带来显着的额外复杂性。 在使用“ ChronoLocalDate ”接口之前， ChronoLocalDate确保已阅读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”定义用于概括null行为。 每个方法都没有明确记录“ @throws NullPointerException ”。

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