Spec-Zone .ru
спецификации, руководства, описания, API
|
public enum ChronoField extends Enum<ChronoField> implements TemporalField
Этот набор полей обеспечивает основанный на поле доступ, чтобы управлять датой, время или разовый датой. Стандартный набор полей может быть расширен, реализовывая TemporalField
.
Эти поля предназначаются, чтобы быть применимыми в многократных календарных системах. Например, большинство календарных систем не-ISO определяет даты как год, месяц и день, только с немного отличающимися правилами. Документация каждого поля объясняет, как это работает.
Перечислимая Константа и Описание |
---|
ALIGNED_DAY_OF_WEEK_IN_MONTH
Выровненный день-недельного в течение месяца.
|
ALIGNED_DAY_OF_WEEK_IN_YEAR
Выровненный день-недельного в течение года.
|
ALIGNED_WEEK_OF_MONTH
Выровненная неделя в течение месяца.
|
ALIGNED_WEEK_OF_YEAR
Выровненная неделя в течение года.
|
AMPM_OF_DAY
"Имею пополудни день".
|
CLOCK_HOUR_OF_AMPM
"Час часов - пополудни".
|
CLOCK_HOUR_OF_DAY
"Час часов дня".
|
DAY_OF_MONTH
День-месячного.
|
DAY_OF_WEEK
День-недельного, такой как во вторник.
|
DAY_OF_YEAR
День-летнего.
|
EPOCH_DAY
Дневное эпохой, основанное на эпохе Java 01.01.1970 (ISO).
|
ERA
Эра.
|
HOUR_OF_AMPM
"Час - пополудни".
|
HOUR_OF_DAY
Час-дневного.
|
INSTANT_SECONDS
Мгновенные секунды эпохи.
|
MICRO_OF_DAY
"Микро изо дня".
|
MICRO_OF_SECOND
"Микро из вторых".
|
MILLI_OF_DAY
milli-of-day.
|
MILLI_OF_SECOND
milli-of-second.
|
MINUTE_OF_DAY
Минута-дневного.
|
MINUTE_OF_HOUR
Минута-часового.
|
MONTH_OF_YEAR
Месяц-летнего, такой как март.
|
NANO_OF_DAY
nano-of-day.
|
NANO_OF_SECOND
nano-of-second.
|
OFFSET_SECONDS
Смещение от UTC/Гринвича.
|
PROLEPTIC_MONTH
Преждевременно-месячные основанные, рассчитывающие месяцы последовательно с года 0.
|
SECOND_OF_DAY
Второе-дневного.
|
SECOND_OF_MINUTE
Второе-минутного.
|
ГОД
Преждевременный год, такой как 2012.
|
YEAR_OF_ERA
Год в пределах эры.
|
Модификатор и Тип | Метод и Описание |
---|---|
<R extends Temporal> |
adjustInto(R temporal, long newValue)
Возвращает копию указанного временного объекта со значением этого полевого набора.
|
int |
checkValidIntValue(long value)
Проверки, что указанное значение допустимо и вписывается
int . |
long |
checkValidValue(long value)
Проверки, что указанное значение допустимо для этого поля.
|
TemporalUnit |
getBaseUnit()
Получает модуль, в котором измеряется поле.
|
Строка |
getDisplayName(Locale locale)
Получает имя дисплея для поля в требуемой локали.
|
long |
getFrom(TemporalAccessor temporal)
Получает значение этого поля от указанного временного объекта.
|
Строка |
getName()
Получает описательное имя для поля.
|
TemporalUnit |
getRangeUnit()
Получает диапазон, которым связывается поле.
|
boolean |
isDateBased()
Проверки, если это поле представляет компонент даты.
|
boolean |
isSupportedBy(TemporalAccessor temporal)
Проверки, если это поле поддерживается временным объектом.
|
boolean |
isTimeBased()
Проверки, если это поле представляет компонент времени.
|
ValueRange |
range()
Получает диапазон допустимых значений для поля.
|
ValueRange |
rangeRefinedBy(TemporalAccessor temporal)
Получите диапазон допустимых значений для этого поля, используя временный объект уточнить результат.
|
Строка |
toString()
Возвращает имя этой перечислимой константы, как содержащийся в объявлении.
|
static ChronoField |
valueOf(String name)
Возвращает перечислимую константу этого типа с указанным именем.
|
static ChronoField[] |
values()
Возвращает массив, содержащий константы этого перечислимого типа, в порядке, которым они объявляются.
|
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf
решение
public static final ChronoField NANO_OF_SECOND
Это считает наносекунду в пределах второго, от 0 до 999 999 999. У этого поля есть то же самое значение для всех календарных систем.
Это поле используется, чтобы представить nano-of-second, обрабатывающий любую часть второго. Реализации TemporalAccessor
должен обеспечить значение для этого поля, если они могут возвратить значение для SECOND_OF_MINUTE
, SECOND_OF_DAY
или INSTANT_SECONDS
заполнение неизвестной точности с нулем.
Когда это поле используется для того, чтобы установить значение, оно должно установить такую большую точность как объектно-ориентированные памяти, используя целочисленное деление, чтобы удалить избыточную точность. Например, если TemporalAccessor
время хранилищ к точности миллисекунды, тогда nano-of-second должен быть разделен на 1 000 000 прежде, чем заменить milli-of-second.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Поле разрешается в комбинации с MILLI_OF_SECOND
и MICRO_OF_SECOND
.
public static final ChronoField NANO_OF_DAY
Это считает наносекунду в течение дня, от 0 до (24 * 60 * 60 * 1 000 000 000) - 1. У этого поля есть то же самое значение для всех календарных систем.
Это поле используется, чтобы представить nano-of-day, обрабатывающий любую часть второго. Реализации TemporalAccessor
должен обеспечить значение для этого поля, если они могут возвратить значение для SECOND_OF_DAY
заполнение неизвестной точности с нулем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Значение разделяется, чтобы сформироваться NANO_OF_SECOND
, SECOND_OF_MINUTE
, MINUTE_OF_HOUR
и HOUR_OF_DAY
поля.
public static final ChronoField MICRO_OF_SECOND
Это считает микросекунду в пределах второго, от 0 до 999 999. У этого поля есть то же самое значение для всех календарных систем.
Это поле используется, чтобы представить микро из второй обработки любой части второго. Реализации TemporalAccessor
должен обеспечить значение для этого поля, если они могут возвратить значение для SECOND_OF_MINUTE
, SECOND_OF_DAY
или INSTANT_SECONDS
заполнение неизвестной точности с нулем.
Когда это поле используется для того, чтобы установить значение, оно должно вести себя таким же образом как установка NANO_OF_SECOND
со значением, умноженным на 1 000.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Поле разрешается в комбинации с MILLI_OF_SECOND
произвести NANO_OF_SECOND
.
public static final ChronoField MICRO_OF_DAY
Это считает микросекунду в течение дня, от 0 до (24 * 60 * 60 * 1 000 000) - 1. У этого поля есть то же самое значение для всех календарных систем.
Это поле используется, чтобы представить обработку, "микро изо дня" любая часть второго. Реализации TemporalAccessor
должен обеспечить значение для этого поля, если они могут возвратить значение для SECOND_OF_DAY
заполнение неизвестной точности с нулем.
Когда это поле используется для того, чтобы установить значение, оно должно вести себя таким же образом как установка NANO_OF_DAY
со значением, умноженным на 1 000.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Значение разделяется, чтобы сформироваться MICRO_OF_SECOND
, SECOND_OF_MINUTE
, MINUTE_OF_HOUR
и HOUR_OF_DAY
поля.
public static final ChronoField MILLI_OF_SECOND
Это считает миллисекунду в пределах второго, от 0 до 999. У этого поля есть то же самое значение для всех календарных систем.
Это поле используется, чтобы представить milli-of-second, обрабатывающий любую часть второго. Реализации TemporalAccessor
должен обеспечить значение для этого поля, если они могут возвратить значение для SECOND_OF_MINUTE
, SECOND_OF_DAY
или INSTANT_SECONDS
заполнение неизвестной точности с нулем.
Когда это поле используется для того, чтобы установить значение, оно должно вести себя таким же образом как установка NANO_OF_SECOND
со значением, умноженным на 1 000 000.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Поле разрешается в комбинации с MICRO_OF_SECOND
произвести NANO_OF_SECOND
.
public static final ChronoField MILLI_OF_DAY
Это считает миллисекунду в течение дня, от 0 до (24 * 60 * 60 * 1 000) - 1. У этого поля есть то же самое значение для всех календарных систем.
Это поле используется, чтобы представить milli-of-day, обрабатывающий любую часть второго. Реализации TemporalAccessor
должен обеспечить значение для этого поля, если они могут возвратить значение для SECOND_OF_DAY
заполнение неизвестной точности с нулем.
Когда это поле используется для того, чтобы установить значение, оно должно вести себя таким же образом как установка NANO_OF_DAY
со значением, умноженным на 1 000 000.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Значение разделяется, чтобы сформироваться MILLI_OF_SECOND
, SECOND_OF_MINUTE
, MINUTE_OF_HOUR
и HOUR_OF_DAY
поля.
public static final ChronoField SECOND_OF_MINUTE
Это считает второе в течение минуты, от 0 до 59. У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме.
public static final ChronoField SECOND_OF_DAY
Это считает второе в течение дня, от 0 до (24 * 60 * 60) - 1. У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Значение разделяется, чтобы сформироваться SECOND_OF_MINUTE
, MINUTE_OF_HOUR
и HOUR_OF_DAY
поля.
public static final ChronoField MINUTE_OF_HOUR
Это считает минуту в течение часа, от 0 до 59. У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме.
public static final ChronoField MINUTE_OF_DAY
Это считает минуту в течение дня, от 0 до (24 * 60) - 1. У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Значение разделяется, чтобы сформироваться MINUTE_OF_HOUR
и HOUR_OF_DAY
поля.
public static final ChronoField HOUR_OF_AMPM
Это считает час в пределах/PM, от 0 до 11. Это - час, который наблюдался бы относительно стандартных 12-часовых электронных часов. У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется от 0 до 11 в строгом и умном режиме. В снисходительном режиме не проверяется значение. Это объединяется с AMPM_OF_DAY
сформироваться HOUR_OF_DAY
умножаясь {AMPM_OF_DAY} оценивают 12.
public static final ChronoField CLOCK_HOUR_OF_AMPM
Это считает час в пределах/PM, от 1 до 12. Это - час, который наблюдался бы относительно стандартных 12-часовых аналоговых стенных часов. У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется от 1 до 12 в строгом режиме и от 0 до 12 в умном режиме. В снисходительном режиме не проверяется значение. Поле преобразовывается в HOUR_OF_AMPM
с тем же самым значением, если значение не 12, когда это преобразовывается в 0.
public static final ChronoField HOUR_OF_DAY
Это считает час в течение дня, от 0 до 23. Это - час, который наблюдался бы относительно стандартных 24-часовых электронных часов. У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется в строгом и умном режиме, но не в снисходительном режиме. Поле объединяется с MINUTE_OF_HOUR
, SECOND_OF_MINUTE
и NANO_OF_SECOND
произвести a LocalTime
. В снисходительном режиме любые избыточные дни добавляются к проанализированной дате, или делаются доступный через DateTimeFormatter.parsedExcessDays()
.
public static final ChronoField CLOCK_HOUR_OF_DAY
Это считает час в пределах/PM, от 1 до 24. Это - час, который наблюдался бы относительно 24-часовых аналоговых стенных часов. У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется от 1 до 24 в строгом режиме и от 0 до 24 в умном режиме. В снисходительном режиме не проверяется значение. Поле преобразовывается в HOUR_OF_DAY
с тем же самым значением, если значение не 24, когда это преобразовывается в 0.
public static final ChronoField AMPM_OF_DAY
Это считает/PM в течение дня от 0 AM до 1 (PM). У этого поля есть то же самое значение для всех календарных систем.
Анализируя это поле это ведет себя эквивалентное следующему: значение проверяется от 0 до 1 в строгом и умном режиме. В снисходительном режиме не проверяется значение. Это объединяется с HOUR_OF_AMPM
сформироваться HOUR_OF_DAY
умножаясь {AMPM_OF_DAY} оценивают 12.
public static final ChronoField DAY_OF_WEEK
Это представляет стандартное понятие дня недели. В значении по умолчанию календарная система ISO у этого есть значения с понедельника (1) к воскресенью (7). DayOfWeek
class может использоваться, чтобы интерпретировать результат.
Большинство календарных систем не-ISO также определяет семидневную неделю, которая выравнивается с ISO. Те календарные системы должны также использовать ту же самую систему нумерации с понедельника (1) к воскресенью (7), который позволяет DayOfWeek
использоваться.
Календарные системы, у которых нет стандартной семидневной недели, должны реализовать это поле, если у них есть подобное понятие именованных или пронумерованных дней в пределах периода, подобного неделе. Рекомендуется, чтобы нумерация запустилась от 1.
public static final ChronoField ALIGNED_DAY_OF_WEEK_IN_MONTH
Это представляет понятие количества дней в течение недели, где недели выровненные к запуску месяца. Это поле обычно используется с ALIGNED_WEEK_OF_MONTH
.
Например, в календаре системы с семидневной неделей, первая "выровненная неделя месяца" запускается в день-месячного 1, вторые выровненные недельные запуски в день-месячного 8, и так далее. В течение каждой из этих выровненных недель дни нумеруются от 1 до 7 и возвращаются как значение этого поля. Также, у дня-месячного 1 - 7 будут значения "выровненным днем недели" от 1 до 7. И день-месячного 8 - 14 повторит это со значениями "выровненный день недели" от 1 до 7.
Календарные системы, у которых нет семидневной недели, должны обычно реализовывать это поле таким же образом, но использование альтернативной недельной длины.
public static final ChronoField ALIGNED_DAY_OF_WEEK_IN_YEAR
Это представляет понятие количества дней в течение недели, где недели выровненные к запуску года. Это поле обычно используется с ALIGNED_WEEK_OF_YEAR
.
Например, в календаре системы с семидневной неделей, первая "выровненная неделя года" запускается в день-летнего 1, вторые выровненные недельные запуски в день-летнего 8, и так далее. В течение каждой из этих выровненных недель дни нумеруются от 1 до 7 и возвращаются как значение этого поля. Также, у дня-летнего 1 - 7 будут значения "выровненным днем недели" от 1 до 7. И день-летнего 8 - 14 повторит это со значениями "выровненный день недели" от 1 до 7.
Календарные системы, у которых нет семидневной недели, должны обычно реализовывать это поле таким же образом, но использование альтернативной недельной длины.
public static final ChronoField DAY_OF_MONTH
Это представляет понятие дня в течение месяца. В значении по умолчанию календарная система ISO у этого есть значения от 1 до 31 через большинство месяцев. Апрель, июнь, сентябрь, у ноября есть дни от 1 до 30, в то время как у февраля есть дни от 1 до 28, или 29 в високосный год.
Календарные системы неISO должны реализовать это поле, используя наиболее распознанные дневные-месячного значения для пользователей календарной системы. Обычно, это - количество дней от 1 до продолжительности месяца.
public static final ChronoField DAY_OF_YEAR
Это представляет понятие дня в течение года. В значении по умолчанию календарная система ISO у этого есть значения от 1 до 365 в стандартных годах и 1 - 366 в високосные годы.
Календарные системы неISO должны реализовать это поле, используя наиболее распознанные дневные-летнего значения для пользователей календарной системы. Обычно, это - количество дней от 1 до продолжительности года.
public static final ChronoField EPOCH_DAY
Это поле является последовательным количеством дней, где 01.01.1970 (ISO) нуль. Отметьте, что это использует локальную временную шкалу, игнорируя смещение и часовой пояс.
Это поле строго определяется, чтобы иметь то же самое значение во всех календарных системах. Это необходимо, чтобы гарантировать взаимодействие между календарями.
public static final ChronoField ALIGNED_WEEK_OF_MONTH
Это представляет понятие количества недель в течение месяца, где недели выровненные к запуску месяца. Это поле обычно используется с ALIGNED_DAY_OF_WEEK_IN_MONTH
.
Например, в календаре системы с семидневной неделей, первая "выровненная неделя месяца" запускается в день-месячного 1, вторые выровненные недельные запуски в день-месячного 8, и так далее. Таким образом день-месячного оценивает 1 - 7, находятся в выровненном недельном 1, в то время как день-месячного оценивает 8 - 14, находятся в выровненных недельных 2, и так далее.
Календарные системы, у которых нет семидневной недели, должны обычно реализовывать это поле таким же образом, но использование альтернативной недельной длины.
public static final ChronoField ALIGNED_WEEK_OF_YEAR
Это представляет понятие количества недель в течение года, где недели выровненные к запуску года. Это поле обычно используется с ALIGNED_DAY_OF_WEEK_IN_YEAR
.
Например, в календаре системы с семидневной неделей, первая "выровненная неделя года" запускается в день-летнего 1, вторые выровненные недельные запуски в день-летнего 8, и так далее. Таким образом день-летнего оценивает 1 - 7, находятся в выровненном недельном 1, в то время как день-летнего оценивает 8 - 14, находятся в выровненных недельных 2, и так далее.
Календарные системы, у которых нет семидневной недели, должны обычно реализовывать это поле таким же образом, но использование альтернативной недельной длины.
public static final ChronoField MONTH_OF_YEAR
Это представляет понятие месяца в течение года. В значении по умолчанию календарная система ISO у этого есть значения с (1) января до (12) декабря.
Календарные системы неISO должны реализовать это поле, используя наиболее распознанные значения месяца-летнего для пользователей календарной системы. Обычно, это - количество месяцев, запускающихся от 1.
public static final ChronoField PROLEPTIC_MONTH
Это поле является последовательным количеством месяцев, где у первого месяца в преждевременно-летнем нуле есть нуль значения. У более поздних месяцев есть все более и более большие значения. У более ранних месяцев есть все более и более маленькие значения. Нет никаких разрывов, или прерывает последовательность месяцев. Отметьте, что это использует локальную временную шкалу, игнорируя смещение и часовой пояс.
В значении по умолчанию календарная система ISO у июня 2012 было бы значение (2012 * 12 + 6 - 1)
. Это поле прежде всего для внутреннего пользования.
Календарные системы неISO должны реализовать это поле согласно определению выше. Это - только простое основанное на нуле количество прошедших месяцев от запуска преждевременно-летних 0. У всех календарных систем с полным преждевременно-летним определением будет нуль года. Если у календарной системы есть минимальный год, который исключает нуль года, то нужно экстраполироваться для этого метода, который будет определен.
public static final ChronoField YEAR_OF_ERA
Это представляет понятие года в пределах эры. Это поле обычно используется с ERA
.
Стандартная умственная модель для даты основана на трех понятиях - год, месяц и день. Они отображаются на YEAR
, MONTH_OF_YEAR
и DAY_OF_MONTH
поля. Отметьте, что нет никакой ссылки на эры. Полная модель для даты требует четырех понятий - эра, год, месяц и день. Они отображаются на ERA
, YEAR_OF_ERA
, MONTH_OF_YEAR
и DAY_OF_MONTH
поля. Ли это поле или YEAR
используется зависит, на котором используется умственная модель. См. ChronoLocalDate
для большего количества обсуждения этой темы.
В значении по умолчанию календарная система ISO есть две определенные эры, 'BCE' и 'CE'. Эра 'CE' является одним использующимся в настоящее время выполнения и выполнения года эры от 1 до максимального значения. Эра 'BCE' является предыдущей эрой, и выполнениями года эры назад.
Например, вычитая год каждый раз урожай следующее:
- преждевременные годом 2 = год эры 'CE' 2
- преждевременный годом 1 = год эры 'CE' 1
- преждевременный годом 0 = год эры 'BCE' 1
- преждевременный годом-1 = год эры 'BCE' 2
Отметьте, что стандарт ISO 8601 фактически не определяет эры. Отметьте также, что эры ISO не выравниваются с известными эрами AD/BC из-за изменения между системами Юлианского и Григорианского календаря.
Календарные системы неISO должны реализовать это поле, используя наиболее распознанное значение года эры для пользователей календарной системы. Так как у большинства календарных систем есть только две эры, подход нумерации года эры обычно будет тем же самым как используемым календарной системой ISO. Значение года эры должно обычно всегда быть положительным, однако это не требуется.
public static final ChronoField YEAR
Это представляет понятие года, рассчитывая последовательно и используя отрицательные числа. Преждевременный год не интерпретируется с точки зрения эры. См. YEAR_OF_ERA
для примера, показывая отображение с преждевременного года до года эры.
Стандартная умственная модель для даты основана на трех понятиях - год, месяц и день. Они отображаются на YEAR
, MONTH_OF_YEAR
и DAY_OF_MONTH
поля. Отметьте, что нет никакой ссылки на эры. Полная модель для даты требует четырех понятий - эра, год, месяц и день. Они отображаются на ERA
, YEAR_OF_ERA
, MONTH_OF_YEAR
и DAY_OF_MONTH
поля. Ли это поле или YEAR_OF_ERA
используется зависит, на котором используется умственная модель. См. ChronoLocalDate
для большего количества обсуждения этой темы.
Календарные системы неISO должны реализовать это поле следующим образом. Если у календарной системы есть только две эры, прежде и после фиксированной даты, то преждевременно-летнее значение должно быть тем же самым как значением года эры в течение более поздней эры, и все более и более отрицательный в течение более ранней эры. Если у календарной системы есть больше чем две эры, то преждевременно-летнее значение может быть определено с помощью любого соответствующего значения, хотя определяя ее, чтобы быть тем же самым, поскольку ISO может быть наилучшим вариантом.
public static final ChronoField ERA
Это представляет понятие эры, которая является крупнейшим подразделением временной шкалы. Это поле обычно используется с YEAR_OF_ERA
.
В значении по умолчанию календарная система ISO есть две определенные эры, 'BCE' и 'CE'. Эра 'CE' является одним использующимся в настоящее время выполнения и выполнения года эры от 1 до максимального значения. Эра 'BCE' является предыдущей эрой, и выполнениями года эры назад. См. YEAR_OF_ERA
для полного примера.
Календарные системы неISO должны реализовать это поле, чтобы определить эры. Значение эры, которая была активной по телефону 01.01.1970 (ISO), должно быть присвоено значение 1. У более ранних эр должны быть последовательно меньшие значения. У более поздних эр должны быть последовательно большие значения,
public static final ChronoField INSTANT_SECONDS
Это представляет понятие последовательного количества секунд, где 1970-01-01T00:00Z (ISO) является нулем. Это поле может использоваться с NANO_OF_DAY
представлять часть дня.
Instant
представляет мгновенную точку на временной шкале. Самостоятельно у них нет никаких элементов, которые позволяют локальной переменной, разовой датой быть полученной. Только когда соединено со смещением или часовым поясом может локальная дата или время быть найденным. Это поле позволяет части секунд момента быть запрошенной.
Это поле строго определяется, чтобы иметь то же самое значение во всех календарных системах. Это необходимо, чтобы гарантировать взаимодействие между календарями.
public static final ChronoField OFFSET_SECONDS
Это представляет понятие смещения в секундах местного времени от UTC/Гринвича.
A ZoneOffset
представляет промежуток времени, что местное время отличается от UTC/Гринвича. Это обычно - постоянное число часов и минут. Это эквивалентно total amount
из смещения в секундах. Например, во время зимнего Парижа имеет смещение +01:00
, который составляет 3600 секунд.
Это поле строго определяется, чтобы иметь то же самое значение во всех календарных системах. Это необходимо, чтобы гарантировать взаимодействие между календарями.
public static ChronoField[] values()
for (ChronoField c : ChronoField.values()) System.out.println(c);
public static ChronoField valueOf(String name)
name
- имя перечислимой константы, которая будет возвращена.IllegalArgumentException
- если у этого перечислимого типа нет никакой константы с указанным именемNullPointerException
- если параметром является нульpublic String getName()
TemporalField
Должный быть формата 'BaseOfRange', таким как 'MonthOfYear', если у поля нет диапазона FOREVER
, когда только основная единица упоминается, такие как 'Год' или 'Эра'.
getName
в интерфейсе TemporalField
public String getDisplayName(Locale locale)
TemporalField
Если нет никакого имени дисплея для локали значения getName
возвращается.
getDisplayName
в интерфейсе TemporalField
locale
- локаль, чтобы использовать, не нульgetName
, не нульpublic TemporalUnit getBaseUnit()
TemporalField
Модуль поля является периодом, который изменяется в пределах диапазона. Например, в поле 'MonthOfYear', модулем являются 'Месяцы'. См. также TemporalField.getRangeUnit()
.
getBaseUnit
в интерфейсе TemporalField
public TemporalUnit getRangeUnit()
TemporalField
Диапазон поля является периодом, в пределах которого изменяется поле. Например, в поле 'MonthOfYear', диапазоном являются 'Годы'. См. также TemporalField.getBaseUnit()
.
Диапазон никогда не является нулем. Например, поле 'Year' является сокращением для 'YearOfForever'. У этого поэтому есть модуль 'Лет' и диапазон 'Навсегда'.
getRangeUnit
в интерфейсе TemporalField
public ValueRange range()
Все поля могут быть выражены как a long
целое число. Этот метод возвращает объект, который описывает допустимый диапазон для того значения.
Этот метод возвращает диапазон поля в календарной системе ISO 8601. Этот диапазон может быть неправильным для других календарных систем. Использовать Chronology.range(ChronoField)
получить доступ к корректному диапазону для различной календарной системы.
Отметьте, что результат только описывает минимальные и максимальные допустимые значения, и важно не читать слишком много в них. Например, могли быть значения в пределах диапазона, которые недопустимы для поля.
range
в интерфейсе TemporalField
public boolean isDateBased()
Поля со дня-недельного до эры основаны на дате.
isDateBased
в интерфейсе TemporalField
public boolean isTimeBased()
Поля от nano-of-second до "имеют пополудни день", основаны на времени.
isTimeBased
в интерфейсе TemporalField
public long checkValidValue(long value)
Это проверяет этого, значение в пределах внешнего диапазона допустимых значений, возвращенных range()
.
Этот метод проверяет по диапазону поля в календарной системе ISO 8601. Этот диапазон может быть неправильным для других календарных систем. Использовать Chronology.range(ChronoField)
получить доступ к корректному диапазону для различной календарной системы.
value
- значение, чтобы проверитьpublic int checkValidIntValue(long value)
int
. Это проверяет этого, значение в пределах внешнего диапазона допустимых значений, возвращенных range()
. Это также проверяет, что все допустимые значения в пределах границ int
.
Этот метод проверяет по диапазону поля в календарной системе ISO 8601. Этот диапазон может быть неправильным для других календарных систем. Использовать Chronology.range(ChronoField)
получить доступ к корректному диапазону для различной календарной системы.
value
- значение, чтобы проверитьpublic boolean isSupportedBy(TemporalAccessor temporal)
TemporalField
Это определяет, поддерживает ли временное средство доступа это поле. Если это возвращает false, временное не может быть запрошено для этого поля.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод непосредственно. Второе должно использовать TemporalAccessor.isSupported(TemporalField)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisField.isSupportedBy(temporal); temporal = temporal.isSupported(thisField);Рекомендуется использовать второй подход,
isSupported(TemporalField)
, поскольку это является намного более четким, чтобы читать в коде. Реализации должны определить, поддерживаются ли они, используя поля, доступные в ChronoField
.
isSupportedBy
в интерфейсе TemporalField
temporal
- временный объект запросить, не нульpublic ValueRange rangeRefinedBy(TemporalAccessor temporal)
TemporalField
Это использует временный объект найти диапазон допустимых значений для поля. Это подобно TemporalField.range()
, однако этот метод уточняет результат, используя временное. Например, если поле DAY_OF_MONTH
range
метод не точен, поскольку есть четыре возможных длины месяца, 28, 29, 30 и 31 день. Используя этот метод с датой позволяет диапазону быть точным, возвращая только одну из тех четырех опций.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод непосредственно. Второе должно использовать TemporalAccessor.range(TemporalField)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisField.rangeRefinedBy(temporal); temporal = temporal.range(thisField);Рекомендуется использовать второй подход,
range(TemporalField)
, поскольку это является намного более четким, чтобы читать в коде. Реализации должны выполнить любые запросы или вычисления, используя поля, доступные в ChronoField
. Если поле не поддерживается UnsupportedTemporalTypeException
должен быть брошен.
rangeRefinedBy
в интерфейсе TemporalField
temporal
- временный объект, используемый, чтобы уточнить результат, не нульpublic long getFrom(TemporalAccessor temporal)
TemporalField
Это запрашивает временный объект для значения этого поля.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод непосредственно. Второе должно использовать TemporalAccessor.getLong(TemporalField)
(или TemporalAccessor.get(TemporalField)
):
// these two lines are equivalent, but the second approach is recommended temporal = thisField.getFrom(temporal); temporal = temporal.getLong(thisField);Рекомендуется использовать второй подход,
getLong(TemporalField)
, поскольку это является намного более четким, чтобы читать в коде. Реализации должны выполнить любые запросы или вычисления, используя поля, доступные в ChronoField
. Если поле не поддерживается UnsupportedTemporalTypeException
должен быть брошен.
getFrom
в интерфейсе TemporalField
temporal
- временный объект запросить, не нульpublic <R extends Temporal> R adjustInto(R temporal, long newValue)
TemporalField
Это возвращает новое временное основанное на объектах на указанном со значением для этого измененного поля. Например, на a LocalDate
, это могло использоваться, чтобы установить год, месяц или день-месячного. У возвращенного объекта есть тот же самый заметный тип как указанный объект.
В некоторых случаях изменение поля не полностью определяется. Например, если целевой объект является датой, представляющей 31-ого января, то изменение месяца до февраля было бы неясно. В случаях как это реализация ответственна за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод непосредственно. Второе должно использовать Temporal.with(TemporalField, long)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisField.adjustInto(temporal); temporal = temporal.with(thisField);Рекомендуется использовать второй подход,
with(TemporalField)
, поскольку это является намного более четким, чтобы читать в коде. Реализации должны выполнить любые запросы или вычисления, используя поля, доступные в ChronoField
. Если поле не поддерживается UnsupportedTemporalTypeException
должен быть брошен.
Реализации не должны изменить указанный временный объект. Вместо этого должна быть возвращена скорректированная копия оригинала. Это обеспечивает эквивалентное, безопасное поведение для неизменных и изменчивых реализаций.
adjustInto
в интерфейсе TemporalField
R
- тип Временного объектаtemporal
- временный объект скорректировать, не нульnewValue
- новое значение поляpublic String toString()
Enum
toString
в class Enum<ChronoField>
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92