Класс JapaneseChronology

public static final JapaneseChronology INSTANCE

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

public String getId()

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

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

public String getCalendarType()

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

Тип календаря — это идентификатор, определённый спецификацией языка разметки данных локалей Unicode (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.