Класс 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(). Реализация предполагает неделю из 7 дней, что первый день месяца имеет значение 1, что первый день года имеет значение 1, и что первое число месяца и года всегда существует.

public boolean isIsoBased()

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