Класс JapaneseChronology

Возвращает идентификатор хронологии — 'Japanese'.

Идентификатор уникально определяет Chronology. Его можно использовать для поиска Chronology с помощью Chronology.of(String).

Возвращает тип календаря базовой календарной системы — 'japanese'.

Тип календаря — это идентификатор, определённый спецификацией Unicode Locale Data Markup Language (LDML). Его можно использовать для поиска Chronology с помощью Chronology.of(String). Его также можно использовать в качестве части локали, доступной через Locale.getUnicodeLocaleType(String) с ключом 'ca'.

Получает локальную дату в японской календарной системе по эпохе, году эпохи, месяцу и дню месяца.

Японский месяц и день месяца такие же, как в системе календаря ISO. Они не сбрасываются при изменении эпохи. Например:

6th Jan Showa 64 = ISO 1989-01-06
  7th Jan Showa 64 = ISO 1989-01-07
  8th Jan Heisei 1 = ISO 1989-01-08
  9th Jan Heisei 1 = ISO 1989-01-09

Получает локальную дату в японской календарной системе по пролептическому году, месяцу и дню месяца.

Пролептический год, месяц и день месяца в японском календаре такие же, как в системе календаря ISO. Они не сбрасываются при изменении эпохи.

Получает локальную дату в японской календарной системе по эпохе, году эпохи и дню года.

День года в этом методе выражается относительно начала года эпохи. Это определение меняет обычное значение дня года только в тех годах, где год эпохи сбрасывается на единицу из-за смены эпохи. Например:

6th Jan Showa 64 = day-of-year 6
  7th Jan Showa 64 = day-of-year 7
  8th Jan Heisei 1 = day-of-year 1
  9th Jan Heisei 1 = day-of-year 2

Получает локальную дату в японской календарной системе по пролептическому году и дню года.

День года в этом методе выражается относительно начала пролептического года. Пролептический год и день года в японском календаре такие же, как в системе календаря ISO. Они не сбрасываются при изменении эпохи.

Получает текущую локальную дату в этой хронологии из системных часов в часовом поясе по умолчанию.

Это запросит system clock в часовом поясе по умолчанию, чтобы получить текущую дату.

Использование этого метода предотвратит возможность использования альтернативных часов для тестирования, так как часы жестко запрограммированы.

Получает текущую локальную дату в этой хронологии из системных часов в указанном часовом поясе.

Это запросит system clock, чтобы получить текущую дату. Указание часового пояса избегает зависимости от часового пояса по умолчанию.

Использование этого метода предотвратит возможность использования альтернативных часов для тестирования, так как часы жестко запрограммированы.

Получает текущую локальную дату в этой хронологии из указанных часов.

Это запросит указанные часы, чтобы получить текущую дату — сегодня. Использование этого метода позволяет использовать альтернативные часы для тестирования. Альтернативные часы могут быть введены с помощью dependency injection.

Получает локальную дату в этой хронологии из другого временного объекта.

Это получает дату в этой хронологии на основе указанного временного объекта. TemporalAccessor представляет собой произвольный набор информации о дате и времени, которую этот фабричный метод преобразует в экземпляр ChronoLocalDate.

Преобразование обычно использует поле EPOCH_DAY, которое стандартизировано для всех календарных систем.

Этот метод соответствует сигнатуре функционального интерфейса TemporalQuery, позволяя использовать его в качестве запроса с помощью ссылки на метод, aChronology::date.

Получает локальное время и дату в этой хронологии из другого временного объекта.

Получает время и дату в этой хронологии на основе указанного временного объекта. TemporalAccessor представляет собой произвольный набор информации о дате и времени, который этот фабричный метод преобразует в экземпляр ChronoLocalDateTime.

Преобразование извлекает и объединяет ChronoLocalDate и LocalTime из временного объекта. Реализации разрешено выполнять оптимизации, такие как доступ к полям, эквивалентным соответствующим объектам. Результат использует эту хронологию.

Этот метод соответствует сигнатуре функционального интерфейса TemporalQuery, позволяя использовать его в качестве запроса с помощью ссылки на метод, aChronology::localDateTime.

Получает ChronoZonedDateTime в этой хронологии из другого временного объекта.

Это получает зонированное время в этой хронологии на основе указанного временного объекта. TemporalAccessor представляет произвольный набор информации о дате и времени, который этот фабричный метод преобразует в экземпляр ChronoZonedDateTime.

Преобразование сначала получит ZoneId из временного объекта, используя ZoneOffset в случае необходимости. Затем оно попытается получить Instant, используя ChronoLocalDateTime в случае необходимости. Результатом будет либо комбинация ZoneId или ZoneOffset с Instant или ChronoLocalDateTime. Реализации разрешается выполнять оптимизации, такие как доступ к тем полям, которые эквивалентны соответствующим объектам. Результат использует эту хронологию.

Этот метод соответствует подписи функционального интерфейса TemporalQuery, что позволяет использовать его в качестве запроса с помощью ссылки на метод, aChronology::zonedDateTime.

Получает ChronoZonedDateTime в этой хронологии из Instant.

Это получает зонированное время с тем же моментом, что и указанный.

Проверяет, является ли указанный год високосным.

Високосные годы японского календаря происходят точно в соответствии с високосными годами ISO. Этот метод не проверяет переданный год и имеет хорошо определенный результат только для годов в поддерживаемом диапазоне.

Вычисляет пролептический год, заданный эрой и годом эры.

Это объединяет эру и год эры в одно поле пролептического года.

Если хронология активно использует эры, такие как JapaneseChronology, то год эры будет проверен на соответствие эры. Для других хронологий проверка является необязательной.

Получает список эр для хронологии.

Большинство систем календарей имеют эру, в пределах которой год имеет смысл. Если система календаря не поддерживает понятие эр, должен возвращаться пустой список.

Получает диапазон допустимых значений для указанного поля.

Все поля могут быть выражены как целое число long. Этот метод возвращает объект, описывающий допустимый диапазон этого значения.

Обратите внимание, что результат описывает только минимальное и максимальное допустимые значения, и не стоит извлекать из них слишком много информации. Например, могут быть значения в диапазоне, которые недопустимы для поля.

Этот метод вернет результат, поддерживает ли хронология это поле или нет.

Преобразует разобранные ChronoField значения в дату во время разбора.

Большинство TemporalField реализаций разрешаются с помощью метода resolve в поле. В отличие от этого, класс ChronoField определяет поля, имеющие смысл только относительно хронологии. Таким образом, ChronoField поля даты разрешаются здесь в контексте конкретной хронологии.

Примеры ChronoField разрешаются этим методом, который может быть переопределён в подклассах.

• EPOCH_DAY - Если присутствует, он преобразуется в дату, и все остальные поля даты затем проверяются на соответствие этой дате.
• PROLEPTIC_MONTH - Если присутствует, он разделяется на YEAR и MONTH_OF_YEAR. Если режим строгий или интеллектуальный, поле проверяется.
• YEAR_OF_ERA и ERA - Если оба присутствуют, они объединяются в YEAR. В режиме допуска диапазон YEAR_OF_ERA не проверяется, в режимах "интеллектуальный" и "строгий" — проверяется. ERA проверяется на соответствие диапазону во всех трёх режимах. Если присутствует только YEAR_OF_ERA, а режим интеллектуальный или допускающий, то предполагается последняя доступная эра. В строгом режиме эра не предполагается, а YEAR_OF_ERA остаётся без изменений. Если присутствует только ERA, оно остаётся без изменений.
• YEAR, MONTH_OF_YEAR и DAY_OF_MONTH - Если все три присутствуют, они объединяются в дату. Во всех трёх режимах YEAR проверяется. Если режим интеллектуальный или строгий, то месяц и день проверяются. Если режим допускающий, дата комбинируется таким образом, как если бы была создана дата на первое число первого месяца в запрошенном году, затем добавлялось различие в месяцах, затем в днях. Если режим интеллектуальный, и день месяца больше максимального для года-месяца, то день месяца корректируется до последнего дня месяца. Если режим строгий, то три поля должны образовывать корректную дату.
• YEAR и DAY_OF_YEAR - Если оба присутствуют, они объединяются в дату. Во всех трёх режимах YEAR проверяется. Если режим допускающий, дата комбинируется таким образом, как если бы была создана дата на первое число запрошенного года, затем добавлялось различие в днях. Если режим интеллектуальный или строгий, то оба поля должны образовывать корректную дату.
• YEAR, MONTH_OF_YEAR, ALIGNED_WEEK_OF_MONTH и ALIGNED_DAY_OF_WEEK_IN_MONTH - Если все четыре присутствуют, они объединяются в дату. Во всех трёх режимах YEAR проверяется. Если режим допускающий, дата комбинируется таким образом, как если бы была создана дата на первое число первого месяца в запрошенном году, затем добавлялось различие в месяцах, затем в неделях, затем в днях. Если режим интеллектуальный или строгий, то все четыре поля проверяются на соответствие внешним диапазонам. Затем дата комбинируется таким образом, как если бы была создана дата на первое число запрошенного года и месяца, а затем добавлялось количество недель и дней, чтобы достичь их значений. Если режим строгий, дата дополнительно проверяется, чтобы убедиться, что корректировка дней и недель не изменила месяц.
• YEAR, MONTH_OF_YEAR, ALIGNED_WEEK_OF_MONTH и DAY_OF_WEEK - Если все четыре присутствуют, они объединяются в дату. Подход аналогичен описанному выше для годов, месяцев и недель в ALIGNED_DAY_OF_WEEK_IN_MONTH. День недели корректируется как следующий или совпадающий день недели после обработки годов, месяцев и недель.
• YEAR, ALIGNED_WEEK_OF_YEAR и ALIGNED_DAY_OF_WEEK_IN_YEAR - Если все три присутствуют, они объединяются в дату. Во всех трёх режимах YEAR проверяется. Если режим допускающий, дата комбинируется таким образом, как если бы была создана дата на первое число запрошенного года, затем добавлялось различие в неделях, затем в днях. Если режим интеллектуальный или строгий, то все три поля проверяются на соответствие внешним диапазонам. Затем дата комбинируется таким образом, как если бы была создана дата на первое число запрошенного года, а затем добавлялось количество недель и дней, чтобы достичь их значений. Если режим строгий, дата дополнительно проверяется, чтобы убедиться, что корректировка дней и недель не изменила год.
• YEAR, ALIGNED_WEEK_OF_YEAR и DAY_OF_WEEK - Если все три присутствуют, они объединяются в дату. Подход аналогичен описанному выше для годов и недель в ALIGNED_DAY_OF_WEEK_IN_YEAR. День недели корректируется как следующий или совпадающий день недели после обработки годов и недель.

Стандартная реализация подходит для большинства систем календарей. Если ChronoField.YEAR_OF_ERA найдено без ChronoField.ERA, используется последняя эра в Chronology.eras(). Реализация предполагает семидневную неделю, что первый день месяца имеет значение 1, первый день года имеет значение 1, и что первое число месяца и года всегда существует.