Класс WeekFields

Стандарт ISO-8601 определяет календарную систему, основанную на неделях. Он использует понятия «год, основанный на неделях», и «неделя года, основанного на неделях», чтобы разделить дни вместо стандартного года/месяца/дня.

Обратите внимание, что первая неделя может начинаться в предыдущем календарном году. Также обратите внимание, что первые несколько дней календарного года могут находиться в годе, основанном на неделях, соответствующем предыдущему календарному году.

Определено как начинающееся с воскресенья и с минимумом 1 дня в месяце. Это определение недели используется в США и других европейских странах.

Это позволяет прибавить или вычесть количество лет, основанных на неделях, к дате. Единица равна либо 52, либо 53 неделям. Оценочная продолжительность года, основанного на неделях, такая же, как у стандартного года ISO в 365.2425 Days.

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

Эта единица — неизменяемый и потокобезопасный синглтон.

Это позволит получить соответствующие значения из поставщика данных локализации. Если регион содержит «fw» (Первый день недели) и/или «rg» (Переопределение региона) Расширения Юникода, возвращаемый экземпляр будет отражать указанные значения с этими расширениями. Если указаны оба «fw» и «rg», значение из расширения «fw» переопределяет неявное значение из расширения «rg».

Первый день недели определяет ISO DayOfWeek , который является 1-м днем недели. Минимальное количество дней в первой неделе определяет, сколько дней должно присутствовать в месяце или году, начиная с первого дня недели, прежде чем неделя будет считаться первой. Значение 1 будет учитывать первый день месяца или года как часть первой недели, а значение 7 потребует всех семи дней, чтобы быть в новом месяце или году.

Экземпляры WeekFields являются синглтонами; для каждой уникальной комбинации firstDayOfWeek и minimalDaysInFirstWeek будет возвращен один и тот же экземпляр.

Первый день недели варьируется в зависимости от культуры. Например, в США используется воскресенье, а во Франции и в стандарте ISO-8601 используется понедельник. Этот метод возвращает первый день, используя стандартный DayOfWeek перечисление.

Количество дней, рассматриваемых для определения первой недели месяца или года, варьируется в зависимости от культуры. Например, ISO-8601 требует 4 дней (более половины недели), чтобы быть присутствующими, прежде чем считать первую неделю.

Это похоже на ChronoField.DAY_OF_WEEK, но использует значения для дня недели, основанные на этой WeekFields. Дни пронумерованы от 1 до 7, где first day-of-week присваивается значение 1.

Например, если первый день недели — воскресенье, то он будет иметь значение 1, а другие дни варьируются от понедельника как 2 до субботы как 7.

На стадии разрешения при парсинге локальный день недели будет преобразован в стандартный ChronoField день недели. День недели должен находиться в допустимом диапазоне от 1 до 7. Другие поля в этом классе создают даты, используя стандартный день недели.

Это представляет собой понятие количества недель в месяце, где недели начинаются в определенный день недели, например, понедельник. Это поле обычно используется с dayOfWeek().

Неделя один (1) — это неделя, начинающаяся в getFirstDayOfWeek(), где в месяце присутствует как минимум getMinimalDaysInFirstWeek() дней. Таким образом, первая неделя может начинаться до minDays дней до начала месяца. Если первая неделя начинается после начала месяца, то период до этого — неделя ноль (0).

Например:
- если 1-й день месяца — понедельник, неделя один начинается с 1-го и нет недели ноль
- если 2-й день месяца — понедельник, неделя один начинается со 2-го, а 1-й — в неделе ноль
- если 4-й день месяца — понедельник, неделя один начинается с 4-го, а с 1-го по 3-й — в неделе ноль
- если 5-й день месяца — понедельник, неделя два начинается с 5-го, а с 1-го по 4-й — в неделе один

Это поле может использоваться с любой календарной системой.

На этапе разрешения при парсинге дата может быть создана из года, недели месяца, месяца года и дня недели.

В строгом режиме все четыре поля проверяются на соответствие допустимому диапазону значений. Поле «неделя месяца» проверяется для обеспечения того, что полученный месяц — запрашиваемый месяц.

В умном режиме все четыре поля проверяются на соответствие допустимому диапазону значений. Поле «неделя месяца» проверяется от 0 до 6, что означает, что полученная дата может быть в другом месяце, отличном от указанного.

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

Это представляет понятие количества недель в году, где недели начинаются в определенный день недели, например, понедельник. Это поле обычно используется с dayOfWeek().

Неделя один (1) — это неделя, начинающаяся в getFirstDayOfWeek(), где в году присутствует как минимум getMinimalDaysInFirstWeek() дней. Таким образом, первая неделя может начинаться до minDays дней до начала года. Если первая неделя начинается после начала года, то период до этого — неделя ноль (0).

Например:
- если 1-й день года — понедельник, неделя один начинается с 1-го и нет недели ноль
- если 2-й день года — понедельник, неделя один начинается со 2-го, а 1-й — в неделе ноль
- если 4-й день года — понедельник, неделя один начинается с 4-го, а с 1-го по 3-й — в неделе ноль
- если 5-й день года — понедельник, неделя два начинается с 5-го, а с 1-го по 4-й — в неделе один

Это поле может использоваться с любой календарной системой.

На этапе разрешения при парсинге дата может быть создана из года, недели года и дня недели.

В строгом режиме все три поля проверяются на соответствие допустимому диапазону значений. Поле «неделя года» проверяется для обеспечения того, что полученный год — запрашиваемый год.

В умном режиме все три поля проверяются на соответствие допустимому диапазону значений. Поле «неделя года» проверяется от 0 до 54, что означает, что полученная дата может быть в другом году, отличном от указанного.

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

Это представляет собой концепцию подсчета недель в году, где недели начинаются с фиксированного дня недели, например, понедельника, и каждая неделя принадлежит ровно одному году. Это поле обычно используется с dayOfWeek() и weekBasedYear().

Неделя первая(1) — это неделя, начинающаяся с getFirstDayOfWeek(), где в году есть как минимум getMinimalDaysInFirstWeek() дней. Если первая неделя начинается после начала года, то период до этого относится к последней неделе предыдущего года.

Например:
- если 1-ый день года — понедельник, неделя первая начинается с 1-го
- если 2-ой день года — понедельник, неделя первая начинается со 2-го, а 1-ый — в последней неделе предыдущего года
- если 4-ый день года — понедельник, неделя первая начинается с 4-го, а 1-ый по 3-ий — в последней неделе предыдущего года
- если 5-ый день года — понедельник, неделя вторая начинается с 5-го, а 1-ый по 4-ый — в первой неделе

Это поле может использоваться с любой системой календаря.

На стадии разрешения при разборе дата может быть создана из недели-года, недели года и дня недели.

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

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

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

Это представляет собой концепцию года, где недели начинаются с фиксированного дня недели, такого как понедельник, и каждая неделя принадлежит ровно одному году. Это поле обычно используется с dayOfWeek() и weekOfWeekBasedYear().

Неделя первая(1) — это неделя, начинающаяся с getFirstDayOfWeek(), где в году есть как минимум getMinimalDaysInFirstWeek() дней. Таким образом, первая неделя может начинаться до начала года. Если первая неделя начинается после начала года, то период до этого относится к последней неделе предыдущего года.

Это поле может использоваться с любой системой календаря.

На стадии разрешения при разборе дата может быть создана из недели-года, недели года и дня недели.

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

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

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

Сравнение основано на полном состоянии правил, то есть на первом дне недели и минимальном количестве дней.