Класс JapaneseChronology

java.lang.Object
- java.time.chrono.AbstractChronology
- - java.time.chrono.JapaneseChronology

Все реализованные интерфейсы:: Serializable, Comparable<Chronology>, Chronology

public final class JapaneseChronology
extends AbstractChronology
implements Serializable

Система японского императорского календаря.

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

Япония ввела григорианский календарь начиная с эпохи Мэйдзи 6. Поддерживаются только эпохи Мэйдзи и более поздние; даты до Мэйдзи 6, 1 января, не поддерживаются.

Поддерживаемые ChronoField экземпляры:

DAY_OF_WEEK
DAY_OF_MONTH
DAY_OF_YEAR
EPOCH_DAY
MONTH_OF_YEAR
PROLEPTIC_MONTH
YEAR_OF_ERA
YEAR
ERA

Требования к реализации:: Этот класс неизменяемый и потокобезопасный.
С тех пор:: 1.8
См. также:: Сериализованная форма

Поля

Модификатор и тип	Поле	Описание
`static JapaneseChronology`	`INSTANCE`	Единственный экземпляр японской хронологии.

Методы

Модификатор и тип	Метод	Описание
`JapaneseDate`	`date(int prolepticYear, int month, int dayOfMonth)`	Получает локальную дату в японской системе календаря из полей пролептического года, месяца и дня месяца.
`JapaneseDate`	`date(Era era, int yearOfEra, int month, int dayOfMonth)`	Получает локальную дату в японской системе календаря из полей эпохи, года эпохи, месяца и дня месяца.
`JapaneseDate`	`dateEpochDay(long epochDay)`	Получает локальную дату в японской системе календаря из дня эпохи.
`JapaneseDate`	`dateYearDay(int prolepticYear, int dayOfYear)`	Получает локальную дату в японской системе календаря из полей пролептического года и дня года.
`JapaneseDate`	`dateYearDay(Era era, int yearOfEra, int dayOfYear)`	Получает локальную дату в японской системе календаря из полей эпохи, года эпохи и дня года.
`JapaneseEra`	`eraOf(int eraValue)`	Возвращает объект эпохи системы календаря из заданного числового значения.
`String`	`getCalendarType()`	Получает тип календаря базовой системы календаря — 'japanese'.
`String`	`getId()`	Получает идентификатор хронологии — 'Japanese'.
`boolean`	`isLeapYear(long prolepticYear)`	Проверяет, является ли указанный год високосным.

Методы, объявленные в классе java.time.chrono.AbstractChronology

compareTo, equals, hashCode, resolveDate, toString

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.time.chrono.Chronology

date, dateNow, dateNow, dateNow, epochSecond, epochSecond, eras, getDisplayName, localDateTime, period, prolepticYear, range, zonedDateTime, zonedDateTime

Поля

INSTANCE

public static final JapaneseChronology INSTANCE

Единственный экземпляр японской хронологии.

Методы

getId

public String getId()

Получает идентификатор хронологии — 'Japanese'.

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

Задано в:: getId в интерфейсе Chronology
Возвращает:: идентификатор хронологии — 'Japanese'
См. также:: getCalendarType()

getCalendarType

public String getCalendarType()

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

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

Задано в:: getCalendarType в интерфейсе Chronology
Возвращает:: тип системы календаря — 'japanese'
См. также:: getId()

date

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

Задано в:: date в интерфейсе Chronology
Параметры:: era — японская эпоха, не null; yearOfEra — год эпохи; month — месяц; dayOfMonth — день месяца
Возвращает:: японскую локальную дату, не null
Исключения:: DateTimeException — если дату невозможно создать; ClassCastException — если era не является JapaneseEra

date

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

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

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

Задано в:: date в интерфейсе Chronology
Параметры:: prolepticYear — пролептический год; month — месяц; dayOfMonth — день месяца
Возвращает:: японскую локальную дату, не null
Исключения:: DateTimeException — если дату невозможно создать

dateYearDay

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

Задано в:: dateYearDay в интерфейсе Chronology
Параметры:: era — японская эпоха, не null; yearOfEra — год эпохи; dayOfYear — день года
Возвращает:: японскую локальную дату, не null
Исключения:: DateTimeException — если дату невозможно создать; ClassCastException — если era не является JapaneseEra

dateYearDay

public JapaneseDate dateYearDay(int prolepticYear,
                                int dayOfYear)

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

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

Задано в:: dateYearDay в интерфейсе Chronology
Параметры:: prolepticYear — пролептический год; dayOfYear — день года
Возвращает:: японскую локальную дату, не null
Исключения:: DateTimeException — если дату невозможно создать

dateEpochDay

public JapaneseDate dateEpochDay(long epochDay)

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

Задано в:: dateEpochDay в интерфейсе Chronology
Параметры:: epochDay — день эпохи
Возвращает:: японскую локальную дату, не null
Исключения:: DateTimeException — если дату невозможно создать

isLeapYear

public boolean isLeapYear(long prolepticYear)

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

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

Задано в:: isLeapYear в интерфейсе Chronology
Параметры:: prolepticYear — пролептический год для проверки, не проверяется на диапазон
Возвращает:: true, если год високосный

eraOf

public JapaneseEra eraOf(int eraValue)

Возвращает объект эпохи системы календаря из заданного числового значения. См. описание каждой эпохи для числовых значений: JapaneseEra.HEISEI, JapaneseEra.SHOWA,JapaneseEra.TAISHO, JapaneseEra.MEIJI), поддерживаются только эпохи Мэйдзи и более поздние.

Задано в:: eraOf в интерфейсе Chronology
Параметры:: eraValue — значение эпохи
Возвращает:: японскую Era для заданного числового значения эпохи
Исключения:: DateTimeException — если eraValue недействителен