compact1, compact2, compact3

java.time.temporal

Класс IsoFields

java.lang. Объект

java.time.temporal. IsoFields

public final class IsoFields
extends Object

Поля и модули, определенные для календарной системы ISO 8601, включая четверть-летнего и "неделя базируемый год".

Этот class определяет поля и модули, которые являются определенными для календарной системы ISO.

Четверть года

Стандарт ISO 8601 основан на стандартном гражданском 12-месячном году. Это обычно делится на четыре четверти, часто сокращаемые как Q1, Q2, Q3 и Q4.

Январь, февраль и март находятся в Q1. Апрель, май и июнь находятся в Q2. Июль, август и сентябрь находятся в Q3. Октябрь, ноябрь и декабрь находятся в Q4.

Полная дата выражается, используя три поля:

• DAY_OF_QUARTER - день в четверти, от 1 до 90, 91 или 92
• QUARTER_OF_YEAR - неделя в течение "недели базируемый год"
• YEAR - стандартный год ISO

Неделя базируемые годы

Стандарт ISO 8601 был первоначально предназначен как формат обмена данными, определяя строковый формат для дат и времена. Однако, это также определяет альтернативный способ выразить дату, основанную на понятии "недели базируемый год".

Дата выражается, используя три поля:

• DAY_OF_WEEK - стандартное поле, определяющее день-недельного с понедельника (1) к воскресенью (7)
• WEEK_OF_WEEK_BASED_YEAR - неделя в течение "недели базируемый год"
• WEEK_BASED_YEAR - "неделя базируемый год"

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

Первая неделя "недели, базируемый год" является первой основанной на понедельнике неделей стандартного года ISO, у которого есть по крайней мере 4 дня в новый год.

• Если 1-ого января понедельник тогда, неделя 1 запускается 1-ого января
• Если 1-ого января вторник тогда, неделя 1 запускается 31-ого декабря предыдущего стандартного года
• Если 1-ого января среда тогда, неделя 1 запускается 30-ого декабря предыдущего стандартного года
• Если 1-ого января четверг тогда, неделя 1 запускается 29-ого декабря предыдущего стандартного года
• Если 1-ого января пятница тогда, неделя 1 запускается 4-ого января
• Если 1-ого января суббота тогда, неделя 1 запускается 3-ьего января
• Если 1-ого января воскресенье тогда, неделя 1 запускается 2-ого января

Есть 52 недели через большинство основанных на неделе лет, однако при случае есть 53 недели.

Например:

Примеры Недели базируемые Годы

Дата	День-недельного	Значения полей
2008-12-28	В воскресенье	Неделя 52 из "недели базируемый год" 2008
2008-12-29	В понедельник	Неделя 1 из "недели базируемый год" 2009
2008-12-31	В среду	Неделя 1 из "недели базируемый год" 2009
2009-01-01	В четверг	Неделя 1 из "недели базируемый год" 2009
2009-01-04	В воскресенье	Неделя 1 из "недели базируемый год" 2009
2009-01-05	В понедельник	Неделя 2 из "недели базируемый год" 2009

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

Этот class является неизменным и ориентированным на многопотоковое исполнение.

С тех пор:

1.8

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static TemporalField	DAY_OF_QUARTER Поле, которое представляет день квартала.
static TemporalField	QUARTER_OF_YEAR Поле, которое представляет четверть-летнего.
static TemporalUnit	QUARTER_YEARS Модуль, который представляет понятие летнего четвертью.
static TemporalField	WEEK_BASED_YEAR Поле, которое представляет "неделю базируемый год".
static TemporalUnit	WEEK_BASED_YEARS Модуль, который представляет недельные на основе годы с целью дополнения и вычитания.
static TemporalField	WEEK_OF_WEEK_BASED_YEAR Поле, которое представляет "неделю недели базируемый год".

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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

DAY_OF_QUARTER

public static final TemporalField DAY_OF_QUARTER

Поле, которое представляет день квартала.

Это поле позволяет значению дня квартала быть запрошенным и установленным. У дня квартала есть значения от 1 до 90 в Q1 стандартного года, от 1 до 91 в Q1 високосного года, от 1 до 91 в Q2 и от 1 до 92 в Q3 и Q4.

День квартала может только быть вычислен, если день-летнего, месяц-летнего и год доступны.

Устанавливая это поле, значению позволяют быть частично снисходительным, принимая любое значение от 1 до 92. Если у четверти есть меньше чем 92 дня, то день 92, и потенциально день 91, находятся в следующей четверти.

В фазе разрешения парсинга дата может быть создана с года, четверти-летнего и день квартала.

В строгом режиме все три поля проверяются против их диапазона допустимых значений. Поле дня квартала проверяется от 1 до 90, 91 или 92 в зависимости от года и четверти.

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

В снисходительном режиме только год проверяется против диапазона допустимых значений. Получающаяся дата вычисляется эквивалентная следующим трем подходам этапа. Во-первых, создайте дату первого января в требуемом году. Затем возьмите четверть-летнего, вычтите один, и добавьте количество в четвертях к дате. Наконец, займите день квартала, вычтите один, и добавьте количество в днях к дате.

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

QUARTER_OF_YEAR

public static final TemporalField QUARTER_OF_YEAR

Поле, которое представляет четверть-летнего.

Это поле позволяет значению четверти-летнего быть запрошенным и установленным. У четверти-летнего есть значения от 1 до 4.

Четверть-летнего может только быть вычислена, если месяц-летнего доступен.

В фазе разрешения парсинга дата может быть создана с года, четверти-летнего и день квартала. См. DAY_OF_QUARTER для деталей.

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

WEEK_OF_WEEK_BASED_YEAR

public static final TemporalField WEEK_OF_WEEK_BASED_YEAR

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

Это поле позволяет неделе значения "неделя базируемый год" быть запрошенной и установленной. "Неделя недели, у базируемого года" есть значения от 1 до 52, или 53, если "неделя у базируемого года" есть 53 недели.

В фазе разрешения парсинга дата может быть создана с "недели базируемый год", "неделя недели базируемый год" и день-недельного.

В строгом режиме все три поля проверяются против их диапазона допустимых значений. Поле "неделя недели базируемый год" проверяется от 1 до 52 или 53 в зависимости от "недели базируемый год".

В умном режиме все три поля проверяются против их диапазона допустимых значений. Поле "неделя недели базируемый год" проверяется между 1 и 53, игнорируя "неделю базируемый год". Если у "недели недели, которая базируемый год" 53, но "неделя базируемый год" только, есть 52 недели, то получающаяся дата находится на неделе 1 из следующей "недели базируемый год".

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

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

WEEK_BASED_YEAR

public static final TemporalField WEEK_BASED_YEAR

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

Это поле позволяет значению "неделя базируемый год" быть запрошенным и установленным.

У поля есть диапазон, который соответствует LocalDate.MAX и LocalDate.MIN.

В фазе разрешения парсинга дата может быть создана с "недели базируемый год", "неделя недели базируемый год" и день-недельного. См. WEEK_OF_WEEK_BASED_YEAR для деталей.

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

WEEK_BASED_YEARS

public static final TemporalUnit WEEK_BASED_YEARS

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

Это позволяет многим недельным на основе годам быть добавленными к, или вычтенными из, дата. Модуль равен или 52 или 53 неделям. Предполагаемая продолжительность "недели базируемый год" является тем же самым как тем из стандартного года ISO в 365.2425 Days.

Правила для дополнения добавляют число недельных на основе лет к существующему значению для поля "неделя базируемый год". Если получающаяся "неделя, у базируемого года" только есть 52 недели, то дата будет на неделе 1 из следующей "недели базируемый год".

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

QUARTER_YEARS

public static final TemporalUnit QUARTER_YEARS

Модуль, который представляет понятие летнего четвертью. Для календарной системы ISO это равно 3 месяцам. Предполагаемая продолжительность летнего четвертью является одной четвертью 365.2425 Days.

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