Пакет java.time.chrono

Общий API для календарных систем, отличных от стандартной ISO.

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

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

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

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

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

• 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. Описание поведения при null-аргументе приводится в комментариях Javadoc с использованием тега «@param». Исключение «@throws NullPointerException» не документируется явно в каждом методе.

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