Пакет java.time.chrono

Универсальный API для календарных систем, отличных от стандартной системы ISO.

Основной API построен на календарной системе, определённой в ISO-8601. Однако существуют и другие календарные системы, для которых этот пакет предоставляет базовую поддержку. Альтернативные календари представлены в пакете java.time.chrono.

Календарная система определяется интерфейсом Chronology, а дата в календарной системе — интерфейсом ChronoLocalDate.

Предполагается, что приложения по возможности используют основной API, в том числе код для чтения и записи данных в постоянное хранилище, например базу данных, и для передачи дат и времени по сети. В таком случае классы "chrono" используются на уровне пользовательского интерфейса для работы с локализованным вводом и выводом. Полное обсуждение этих вопросов см. в разделе ChronoLocalDate.

Использование в приложении календарных систем, отличных от ISO, значительно усложняет его. Перед работой с интерфейсами "chrono" ознакомьтесь с предупреждениями и рекомендациями в ChronoLocalDate.

Поддерживаются следующие календарные системы:

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

Пример

В этом примере выводится сегодняшняя дата для всех доступных календарей.

  // Enumerate the list of available calendars and print today's 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. Для краткого описания поведения при передаче null используется определение Javadoc "@param". Указание "@throws NullPointerException" явно не приводится для каждого метода.

Все вычисления должны проверять числовое переполнение и выбрасывать либо исключение ArithmeticException, либо DateTimeException.