compact1, compact2, compact3

java.time.chrono

Эра интерфейса

Все Суперинтерфейсы:

TemporalAccessor, TemporalAdjuster

Все Известные Классы с реализацией:

HijrahEra, IsoEra, JapaneseEra, MinguoEra, ThaiBuddhistEra

Функциональный Интерфейс:

Это - функциональный интерфейс и может поэтому использоваться в качестве цели присвоения для ссылки метода или лямбда-выражения.

public interface Era
extends TemporalAccessor, TemporalAdjuster

Эра временной шкалы.

У большинства календарных систем есть единственная эпоха, делящая временную шкалу на две эры. Однако, некоторые календарные системы, имейте многократные эры, такой как один для господства каждого лидера. Во всех случаях эра является концептуально крупнейшим подразделением временной шкалы. Каждая хронология определяет Эру, которые являются известными Эрами и a Chronology.eras получить допустимые эры.

Например, тайская буддистская календарная система делит время на две эры, прежде и после единственной даты. В отличие от этого, у японской календарной системы есть одна эра для господства каждого Императора.

Экземпляры Era может быть сравнен, используя == оператор.

Требования реализации:

Этот интерфейс должен быть реализован с заботой, чтобы гарантировать, что другие классы работают правильно. Все реализации должны быть одиночными элементами - заключительный, неизменный и ориентированный на многопотоковое исполнение. Рекомендуется использовать перечисление когда бы ни было возможно.

С тех пор:

1.8

Сводка метода

Модификатор и Тип	Метод и Описание
default Temporal	adjustInto(Temporal temporal) Корректирует указанный временный объект иметь ту же самую эру как этот объект.
default int	get(TemporalField field) Получает значение указанного поля с этой эры как int.
default String	getDisplayName(TextStyle style, Locale locale) Получает текстовое представление этой эры.
default long	getLong(TemporalField field) Получает значение указанного поля с этой эры как a long.
int	getValue() Связали числовое значение с эрой как определено хронологией.
default boolean	isSupported(TemporalField field) Проверки, если указанное поле поддерживается.
default <R> R	query(TemporalQuery<R> query) Запросы эта эра, используя указанный запрос.
default ValueRange	range(TemporalField field) Получает диапазон допустимых значений для указанного поля.

Методы, наследованные от интерфейса java.time.temporal. TemporalAdjuster

dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame

Деталь метода

getValue

int getValue()

Связали числовое значение с эрой как определено хронологией. Каждая хронология определяет предопределенные Эры и методы, чтобы перечислить Эры хронологии.

У всех полей, включая эры, есть связанное числовое значение. Значение числового значения в течение эры определяется хронологией согласно этим принципам:

• У эры в использовании в эпохе 01.01.1970 (ISO) есть значение 1.
• У более поздних эр есть последовательно более высокие значения.
• У более ранних эр есть последовательно нижние значения, которые могут быть отрицательными.

Возвраты:

числовое значение эры

isSupported

default boolean isSupported(TemporalField field)

Проверки, если указанное поле поддерживается.

Это проверяет, может ли эта эра быть запрошена для указанного поля. Если ложь, то вызов range и get методы выдадут исключение.

Если поле является a ChronoField тогда запрос реализуется здесь. ERA поле возвращает true. Все другой ChronoField экземпляры возвратят false.

Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.isSupportedBy(TemporalAccessor) передача this как параметр. Поддерживается ли поле, определяется полем.

Определенный:

isSupported в интерфейсе TemporalAccessor

Параметры:

field - поле, чтобы проверить, обнулите, возвращает false

Возвраты:

истина, если поле поддерживается на этой эре, ложь если нет

диапазон

default ValueRange range(TemporalField field)

Получает диапазон допустимых значений для указанного поля.

Объект диапазона выражает минимальные и максимальные допустимые значения для поля. Эта эра используется, чтобы улучшить точность возвращенного диапазона. Если не возможно возвратить диапазон, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.

Если поле является a ChronoField тогда запрос реализуется здесь. ERA поле возвращает диапазон. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.

Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.rangeRefinedBy(TemporalAccessor) передача this как параметр. Может ли диапазон быть получен, определяется полем.

Реализация по умолчанию должна возвратить диапазон для ERA от нуля до одного, подходящего для двух календарных систем эры, таких как ISO.

Определенный:

range в интерфейсе TemporalAccessor

Параметры:

field - поле, чтобы запросить диапазон для, не нуль

Возвраты:

диапазон допустимых значений для поля, не нуль

Броски:

DateTimeException - если диапазон для поля не может быть получен

UnsupportedTemporalTypeException - если модуль не поддерживается

добраться

default int get(TemporalField field)

Получает значение указанного поля с этой эры как int.

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

Если поле является a ChronoField тогда запрос реализуется здесь. ERA поле возвращает значение эры. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.

Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor) передача this как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.

Определенный:

get в интерфейсе TemporalAccessor

Параметры:

field - поле, чтобы получить, не нуль

Возвраты:

значение для поля

Броски:

DateTimeException - если значение для поля не может быть получено, или значение вне диапазона допустимых значений для поля

UnsupportedTemporalTypeException - если поле не поддерживается, или диапазон значений превышает int

ArithmeticException - если числовое переполнение происходит

getLong

default long getLong(TemporalField field)

Получает значение указанного поля с этой эры как a long.

Это запрашивает эту эру для значения для указанного поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.

Если поле является a ChronoField тогда запрос реализуется здесь. ERA поле возвращает значение эры. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.

Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor) передача this как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.

Определенный:

getLong в интерфейсе TemporalAccessor

Параметры:

field - поле, чтобы получить, не нуль

Возвраты:

значение для поля

Броски:

DateTimeException - если значение для поля не может быть получено

UnsupportedTemporalTypeException - если поле не поддерживается

ArithmeticException - если числовое переполнение происходит

запрос

default <R> R query(TemporalQuery<R> query)

Запросы эта эра, используя указанный запрос.

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

Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor) метод на указанной передаче запроса this как параметр.

Определенный:

query в интерфейсе TemporalAccessor

Введите Параметры:

R - тип результата

Параметры:

query - запрос, чтобы вызвать, не нуль

Возвраты:

результат запроса, нуль может быть возвращен (определенный запросом)

Броски:

DateTimeException - если неспособный запрашивать (определенный запросом)

ArithmeticException - если числовое переполнение происходит (определенный запросом)

adjustInto

default Temporal adjustInto(Temporal temporal)

Корректирует указанный временный объект иметь ту же самую эру как этот объект.

Это возвращает временный объект того же самого заметного типа как ввод с эрой, измененной, чтобы быть тем же самым как этим.

Корректировка эквивалентна использованию Temporal.with(TemporalField, long) передача ChronoField.ERA как поле.

В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster):

   // these two lines are equivalent, but the second approach is recommended
   temporal = thisEra.adjustInto(temporal);
   temporal = temporal.with(thisEra);
 

Этот экземпляр является неизменным и незатронутым этим вызовом метода.

Определенный:

adjustInto в интерфейсе TemporalAdjuster

Параметры:

temporal - целевой объект, который будет скорректирован, не нуль

Возвраты:

скорректированный объект, не нуль

Броски:

DateTimeException - если неспособный вносить корректировку

ArithmeticException - если числовое переполнение происходит

getDisplayName

default String getDisplayName(TextStyle style,
                              Locale locale)

Получает текстовое представление этой эры.

Это возвращает текстовое имя, используемое, чтобы идентифицировать эру, подходящую для представления пользователю. Параметры управляют стилем возвращенного текста и локали.

Если никакое текстовое отображение не находится тогда numeric value возвращается.

Эта реализация по умолчанию является подходящей для всех реализаций.

Параметры:

style - стиль требуемого текста, не нуль

locale - локаль, чтобы использовать, не нуль

Возвраты:

текстовое значение эры, не нуль