Класс WeekFields

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

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

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

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

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

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

Метод ищет подходящие значения у поставщика данных локализации. Если локаль содержит расширения Unicode "fw" (первый день недели) и/или "rg" (переопределение региона), возвращаемый экземпляр будет учитывать значения, заданные этими расширениями. Если указаны и "fw", и "rg", значение из расширения "fw" имеет приоритет над неявным значением из расширения "rg".

Например, пользователи, которым нужна английская локаль, но которые хотят использовать первый день недели согласно стандарту ISO-8601, могут вызвать

Locale enIsoLoc = Locale.forLanguageTag("en-u-fw-mon");
WeekFields.of(enIsoLoc).getFirstDayOfWeek(); // returns MONDAY

Первый день недели задает день 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-го числа, и недели 0 нет
- если 2-е число месяца приходится на понедельник, первая неделя начинается 2-го числа, а 1-е число относится к неделе 0
- если 4-е число месяца приходится на понедельник, первая неделя начинается 4-го числа, а числа с 1-го по 3-е относятся к неделе 0
- если 5-е число месяца приходится на понедельник, вторая неделя начинается 5-го числа, а числа с 1-го по 4-е относятся к первой неделе

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

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

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

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

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

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

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

Например:
- если 1-й день года приходится на понедельник, первая неделя начинается 1-го числа, и недели 0 нет
- если 2-й день года приходится на понедельник, первая неделя начинается 2-го числа, а 1-е число относится к неделе 0
- если 4-й день года приходится на понедельник, первая неделя начинается 4-го числа, а числа с 1-го по 3-е относятся к неделе 0
- если 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, поэтому результирующая дата может оказаться в следующем году такой системы по сравнению с указанным.

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

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