Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class JapaneseChronology extends Chronology implements Serializable
Эта хронология определяет правила японской Имперской календарной системы. Эта календарная система прежде всего используется в Японии. Японская Имперская календарная система является тем же самым как календарной системой ISO кроме основанного на эре года, нумеруя.
Только Мэйдзи (07.04.1865 - 07.09.1868) и более поздние эры поддерживается. Более старые эры обрабатываются как неизвестная эра, где год эры является годом ISO.
Модификатор и Тип | Поле и Описание |
---|---|
static JapaneseChronology |
ЭКЗЕМПЛЯР
Экземпляр Singleton для японской хронологии.
|
Модификатор и Тип | Метод и Описание |
---|---|
JapaneseDate |
date(Era era, int yearOfEra, int month, int dayOfMonth)
Получает локальную дату в японской календарной системе с эры, года эры, месяца-летнего и дневных-месячного полей.
|
JapaneseDate |
date(int prolepticYear, int month, int dayOfMonth)
Получает локальную дату в японской календарной системе от преждевременно-летнего, месяц-летнего и дневные-месячного поля.
|
JapaneseDate |
date(TemporalAccessor temporal)
Получает локальную дату в этой хронологии от другого временного объекта.
|
JapaneseDate |
dateEpochDay(long epochDay)
Получает локальную дату в японской календарной системе от дневного эпохой.
|
JapaneseDate |
dateNow()
Получает текущую локальную дату в этой хронологии от системных часов в часовом поясе значения по умолчанию.
|
JapaneseDate |
dateNow(Clock clock)
Получает текущую локальную дату в этой хронологии от указанных часов.
|
JapaneseDate |
dateNow(ZoneId zone)
Получает текущую локальную дату в этой хронологии от системных часов в указанном часовом поясе.
|
JapaneseDate |
dateYearDay(Era era, int yearOfEra, int dayOfYear)
Получает локальную дату в японской календарной системе с эры, года эры и дневных-летнего полей.
|
JapaneseDate |
dateYearDay(int prolepticYear, int dayOfYear)
Получает локальную дату в японской календарной системе от преждевременно-летних полей и дневных-летнего полей.
|
Эра |
eraOf(int eraValue)
Возвращает календарный системный объект эры из данного числового значения.
|
List<Era> |
eras()
Получает список эр для хронологии.
|
Строка |
getCalendarType()
Получает тип календаря базовой календарной системы - 'японский язык'.
|
Строка |
getId()
Получает ID хронологии - 'японский язык'.
|
boolean |
isLeapYear(long prolepticYear)
Проверки, если указанный год является високосным годом.
|
ChronoLocalDateTime<JapaneseDate> |
localDateTime(TemporalAccessor temporal)
Получает локальную переменную, разовую датой в этой хронологии от другого временного объекта.
|
int |
prolepticYear(Era era, int yearOfEra)
Вычисляет преждевременно-летнее, данное эру и год эры.
|
ValueRange |
range(ChronoField field)
Получает диапазон допустимых значений для указанного поля.
|
ChronoZonedDateTime<JapaneseDate> |
zonedDateTime(Instant instant, ZoneId zone)
Получает a
ChronoZonedDateTime в этой хронологии от Instant . |
ChronoZonedDateTime<JapaneseDate> |
zonedDateTime(TemporalAccessor temporal)
Получает a
ChronoZonedDateTime в этой хронологии от другого временного объекта. |
compareTo, equals, from, getAvailableChronologies, getDisplayName, hashCode, of, ofLocale, resolveDate, toString, writeReplace
public static final JapaneseChronology INSTANCE
public String getId()
ID однозначно определяет Chronology
. Это может привыкнуть к поиску Chronology
использование Chronology.of(String)
.
getId
в class Chronology
getCalendarType()
public String getCalendarType()
Тип календаря является идентификатором, определенным Языком разметки Данных Локали Unicode (LDML) спецификация. Это может привыкнуть к поиску Chronology
использование Chronology.of(String)
. Это может также использоваться в качестве части локали, доступной через Locale.getUnicodeLocaleType(String)
с ключом 'приблизительно'.
getCalendarType
в class Chronology
getId()
public JapaneseDate date(Era era, int yearOfEra, int month, int dayOfMonth)
date
в class Chronology
era
- японская эра, не нульyearOfEra
- год эрыmonth
- месяц-летнегоdayOfMonth
- день-месячногоDateTimeException
- если неспособный создать датуClassCastException
- если era
не a JapaneseEra
public JapaneseDate date(int prolepticYear, int month, int dayOfMonth)
date
в class Chronology
prolepticYear
- преждевременно-летнееmonth
- месяц-летнегоdayOfMonth
- день-месячногоDateTimeException
- если неспособный создать датуpublic JapaneseDate dateYearDay(Era era, int yearOfEra, int dayOfYear)
dateYearDay
в class Chronology
era
- японская эра, не нульyearOfEra
- год эрыdayOfYear
- день-летнегоDateTimeException
- если неспособный создать датуClassCastException
- если era
не a JapaneseEra
public JapaneseDate dateYearDay(int prolepticYear, int dayOfYear)
dateYearDay
в class Chronology
prolepticYear
- преждевременно-летнееdayOfYear
- день-летнегоDateTimeException
- если неспособный создать датуpublic JapaneseDate dateEpochDay(long epochDay)
dateEpochDay
в class Chronology
epochDay
- день эпохиDateTimeException
- если неспособный создать датуpublic JapaneseDate dateNow()
Chronology
Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущую дату.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
Эта реализация использование Chronology.dateNow(Clock)
.
dateNow
в class Chronology
public JapaneseDate dateNow(ZoneId zone)
Chronology
Это запросит system clock
получить текущую дату. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
dateNow
в class Chronology
zone
- зональный ID, чтобы использовать, не нульpublic JapaneseDate dateNow(Clock clock)
Chronology
Это запросит указанные часы, чтобы получить текущую дату - сегодня. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection
.
dateNow
в class Chronology
clock
- часы, чтобы использовать, не нульpublic JapaneseDate date(TemporalAccessor temporal)
Chronology
Это получает дату в этой хронологии, основанной на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр ChronoLocalDate
.
Преобразование обычно использует EPOCH_DAY
поле, которое стандартизируется через календарные системы.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, aChronology::date
.
date
в class Chronology
temporal
- временный объект преобразовать, не нульChronoLocalDate.from(TemporalAccessor)
public ChronoLocalDateTime<JapaneseDate> localDateTime(TemporalAccessor temporal)
Chronology
Это получает разовое датой в этой хронологии, основанной на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр ChronoLocalDateTime
.
Преобразование извлекает и объединяется ChronoLocalDate
и LocalTime
от временного объекта. Реализациям разрешают выполнить оптимизацию, такую как доступ к тем полям, которые эквивалентны соответствующим объектам. Результат использует эту хронологию.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, aChronology::localDateTime
.
localDateTime
в class Chronology
temporal
- временный объект преобразовать, не нульChronoLocalDateTime.from(TemporalAccessor)
public ChronoZonedDateTime<JapaneseDate> zonedDateTime(TemporalAccessor temporal)
Chronology
ChronoZonedDateTime
в этой хронологии от другого временного объекта. Это получает зонное разовое датой в этой хронологии, основанной на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр ChronoZonedDateTime
.
Преобразование сначала получит a ZoneId
от временного объекта, отступая к a ZoneOffset
в случае необходимости. Это тогда попытается получить Instant
, отступание к a ChronoLocalDateTime
в случае необходимости. Результатом будет любой комбинация ZoneId
или ZoneOffset
с Instant
или ChronoLocalDateTime
. Реализациям разрешают выполнить оптимизацию, такую как доступ к тем полям, которые эквивалентны соответствующим объектам. Результат использует эту хронологию.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, aChronology::zonedDateTime
.
zonedDateTime
в class Chronology
temporal
- временный объект преобразовать, не нульChronoZonedDateTime.from(TemporalAccessor)
public ChronoZonedDateTime<JapaneseDate> zonedDateTime(Instant instant, ZoneId zone)
Chronology
ChronoZonedDateTime
в этой хронологии от Instant
. Это получает зонное разовое датой с тем же самым моментом, как это определило.
zonedDateTime
в class Chronology
instant
- момент, чтобы создать разовое датой из, не нульzone
- часовой пояс, не нульpublic boolean isLeapYear(long prolepticYear)
Японские календарные високосные годы происходят точно в соответствии с високосными годами ISO. Этот метод не проверяет года, который передают в, и только имеет четко определенный результат в течение многих лет в поддерживаемом диапазоне.
isLeapYear
в class Chronology
prolepticYear
- преждевременно-летнее, чтобы проверить, не проверил для диапазонаpublic int prolepticYear(Era era, int yearOfEra)
Chronology
Это комбинирует эру и год эры в единственное преждевременно-летнее поле.
Если хронология делает активное использование эр, такой как JapaneseChronology
тогда год эры будет проверен против эры. Для других хронологий проверка допустимости является дополнительной.
prolepticYear
в class Chronology
era
- эра корректного типа для хронологии, не нульyearOfEra
- год эры хронологииpublic Era eraOf(int eraValue)
JapaneseEra.HEISEI
, JapaneseEra.SHOWA
,JapaneseEra.TAISHO
, JapaneseEra.MEIJI
), только Мэйдзи и более поздние эры поддерживается. До Мэйдзи JapaneseEra.SEIREKI
используется.eraOf
в class Chronology
eraValue
- значение эрыEra
для данного числового значения эрыDateTimeException
- если eraValue
недопустимоpublic List<Era> eras()
Chronology
У большинства календарных систем есть эра, в пределах которой у года есть значение. Если календарная система не поддерживает понятие эр, пустой список должен быть возвращен.
eras
в class Chronology
public ValueRange range(ChronoField field)
Chronology
Все поля могут быть выражены как a long
целое число. Этот метод возвращает объект, который описывает допустимый диапазон для того значения.
Отметьте, что результат только описывает минимальные и максимальные допустимые значения, и важно не читать слишком много в них. Например, могли быть значения в пределах диапазона, которые недопустимы для поля.
Этот метод возвратит результат, поддерживает ли хронология поле.
range
в class Chronology
field
- поле, чтобы получить диапазон для, не нуль
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92