Класс 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)

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

Получает дату в этой хронологии на основе указанного временного представления. Объект временного представления представляет собой произвольную совокупность информации о дате и времени, которую этот фабричный метод преобразует в экземпляр 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, и что первое число месяца и года всегда существует.