Класс JapaneseChronology

public static final JapaneseChronology INSTANCE

Экземпляр-синглтон для японской хронологии.

public String getId()

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

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

public String getCalendarType()

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

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

public JapaneseDate date(Era era, int yearOfEra, int month, int dayOfMonth)

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

Японский месяц и день месяца такие же, как в 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
 

public JapaneseDate date(int prolepticYear, int month, int dayOfMonth)

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

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

public JapaneseDate dateYearDay(Era era, int yearOfEra, int dayOfYear)

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

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

  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
 

public JapaneseDate dateYearDay(int prolepticYear, int dayOfYear)

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

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

public JapaneseDate dateEpochDay(long epochDay)

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

public JapaneseDate dateNow()

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

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

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

public JapaneseDate dateNow(ZoneId zone)

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

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

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

public JapaneseDate dateNow(Clock clock)

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

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

public JapaneseDate date(TemporalAccessor temporal)

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

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

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

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

public ChronoLocalDateTime<JapaneseDate> localDateTime(TemporalAccessor temporal)

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

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

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

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

public ChronoZonedDateTime<JapaneseDate> zonedDateTime(TemporalAccessor temporal)

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

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

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

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

public ChronoZonedDateTime<JapaneseDate> zonedDateTime(Instant instant, ZoneId zone)

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

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

public boolean isLeapYear(long prolepticYear)

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

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

public int prolepticYear(Era era, int yearOfEra)

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

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

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

public JapaneseEra eraOf(int eraValue)

Возвращает объект эры системы календаря из данного числового значения. Числовые значения, поддерживаемые этим методом, совпадают с числовыми значениями, поддерживаемыми JapaneseEra.of(int).

public List<Era> eras()

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

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

public ValueRange range(ChronoField field)

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

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

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

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

public JapaneseDate resolveDate(Map<TemporalField, Long> fieldValues, ResolverStyle resolverStyle)

Разрешает значения разобранных 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, и что первый день месяца и года всегда существует.

public boolean isIsoBased()

JapaneseChronology — это хронология на основе ISO, которая поддерживает поля в IsoFields, такие как DAY_OF_QUARTER и QUARTER_OF_YEAR.