compact1, compact2, compact3

java.time.temporal

Класс WeekFields

java.lang. Объект

java.time.temporal. WeekFields

Все Реализованные Интерфейсы:

Сериализуемый

public final class WeekFields
extends Object
implements Serializable

Локализованные определения дня-недельного, недели-месячного и недельных-летнего полей.

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

WeekFields обеспечивает пять полей, dayOfWeek(), weekOfMonth(), weekOfYear(), weekOfWeekBasedYear(), и weekBasedYear() это обеспечивает доступ к значениям от любого временного объекта.

Вычисления в течение дня-недельного, недели-месячного, и недели-летнего основаны на преждевременно-летнем, месяц-летнего, день-месячного, и день-недельного ISO, которые основаны на дневном эпохой и хронологии. Значения, возможно, не выровненные года эры в зависимости от Хронологии.

Неделя определяется:

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

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

Неделя Месяца

Одно поле используется: неделя-месячного. Вычисление гарантирует, что недели никогда не перекрывают границу месяца. Месяц делится на периоды, где каждый период запускается в определенный первый день-недельного. Самый ранний период упоминается как неделя 0, если у этого есть меньше чем минимальное число дней и недели 1, если у этого есть, по крайней мере, минимальное число дней.

Примеры WeekFields

Дата	День-недельного	Первый день: в понедельник Минимальные дни: 4	Первый день: в понедельник Минимальные дни: 5
2008-12-31	В среду	Неделя 5 декабря 2008	Неделя 5 декабря 2008
2009-01-01	В четверг	Неделя 1 января 2009	Неделя 0 из января 2009
2009-01-04	В воскресенье	Неделя 1 января 2009	Неделя 0 из января 2009
2009-01-05	В понедельник	Неделя 2 января 2009	Неделя 1 января 2009

Неделя Года

Одно поле используется: неделя-летнего. Вычисление гарантирует, что недели никогда не перекрывают границу года. Год делится на периоды, где каждый период запускается в определенный первый день-недельного. Самый ранний период упоминается как неделя 0, если у этого есть меньше чем минимальное число дней и недели 1, если у этого есть, по крайней мере, минимальное число дней.

Неделя Основанный Год

Два поля используются в течение "недели базируемый год", один для week-of-week-based-year и один для week-based-year. Через "неделю базируемый год", каждую неделю принадлежит только году. Неделя 1 из года является первой неделей, которая запускается в первый день-недельного и имеет, по крайней мере, минимальное число дней. Первые и последние недели года могут содержать дни с предыдущего календарного года или следующего календарного года соответственно.

Примеры WeekFields в течение "недели базируемый год"

Дата	День-недельного	Первый день: в понедельник Минимальные дни: 4	Первый день: в понедельник Минимальные дни: 5
2008-12-31	В среду	Неделя 1 из 2009	Неделя 53 из 2008
2009-01-01	В четверг	Неделя 1 из 2009	Неделя 53 из 2008
2009-01-04	В воскресенье	Неделя 1 из 2009	Неделя 53 из 2008
2009-01-05	В понедельник	Неделя 2 из 2009	Неделя 1 из 2009

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

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

С тех пор:

1.8

См. Также:

Сериализированная Форма

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

Поля

Модификатор и Тип	Поле и Описание
static WeekFields	ISO У определения ISO 8601, где неделя запускается в понедельник и первая неделя, есть минимум 4 дней.
static WeekFields	SUNDAY_START У общего определения недели, которая запускается в воскресенье и первая неделя, есть минимум 1 дня.
static TemporalUnit	WEEK_BASED_YEARS Модуль, который представляет недельные на основе годы с целью дополнения и вычитания.

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

Модификатор и Тип	Метод и Описание
TemporalField	dayOfWeek() Возвращает поле, чтобы получить доступ ко дню недели, основанной на этом WeekFields.
boolean	equals(Object object) Проверки, если это WeekFields равно указанному объекту.
DayOfWeek	getFirstDayOfWeek() Получает первый день-недельного.
int	getMinimalDaysInFirstWeek() Получает минимальное число дней на первой неделе.
int	hashCode() Хэш-код для этого WeekFields.
static WeekFields	of(DayOfWeek firstDayOfWeek, int minimalDaysInFirstWeek) Получает экземпляр WeekFields с первого дня-недельного и минимальных дней.
static WeekFields	of(Locale locale) Получает экземпляр WeekFields соответствующий для локали.
Строка	toString() Строковое представление этого WeekFields экземпляр.
TemporalField	weekBasedYear() Возвращает поле, чтобы получить доступ к году "недели базируемый год", основанный на этом WeekFields.
TemporalField	weekOfMonth() Возвращает поле, чтобы получить доступ к неделе месяца, основанного на этом WeekFields.
TemporalField	weekOfWeekBasedYear() Возвращает поле, чтобы получить доступ к неделе "недели базируемый год", основанный на этом WeekFields.
TemporalField	weekOfYear() Возвращает поле, чтобы получить доступ к неделе года, основанного на этом WeekFields.

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

ISO

public static final WeekFields ISO

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

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

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

SUNDAY_START

public static final WeekFields SUNDAY_START

У общего определения недели, которая запускается в воскресенье и первая неделя, есть минимум 1 дня.

Определенный как запускающийся в воскресенье и с минимумом 1 дня в месяце. На этой неделе определение используется в US и других европейских странах.

WEEK_BASED_YEARS

public static final TemporalUnit WEEK_BASED_YEARS

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

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

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

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

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

из

public static WeekFields of(Locale locale)

Получает экземпляр WeekFields соответствующий для локали.

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

Параметры:

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

Возвраты:

недельное определение, не нуль

из

public static WeekFields of(DayOfWeek firstDayOfWeek,
                            int minimalDaysInFirstWeek)

Получает экземпляр WeekFields с первого дня-недельного и минимальных дней.

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

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

Параметры:

firstDayOfWeek - первый день недели, не нуль

minimalDaysInFirstWeek - минимальное число дней на первой неделе, от 1 до 7

Возвраты:

недельное определение, не нуль

Броски:

IllegalArgumentException - если минимальное дневное значение - меньше чем один или больше чем 7

getFirstDayOfWeek

public DayOfWeek getFirstDayOfWeek()

Получает первый день-недельного.

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

Возвраты:

первый день-недельного, не нуль

getMinimalDaysInFirstWeek

public int getMinimalDaysInFirstWeek()

Получает минимальное число дней на первой неделе.

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

Возвраты:

минимальное число дней на первой неделе месяца или года, от 1 до 7

dayOfWeek

public TemporalField dayOfWeek()

Возвращает поле, чтобы получить доступ ко дню недели, основанной на этом WeekFields.

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

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

Возвраты:

полевой доступ обеспечения ко дню-недельного с локализованной нумерацией, не нуль

weekOfMonth

public TemporalField weekOfMonth()

Возвращает поле, чтобы получить доступ к неделе месяца, основанного на этом WeekFields.

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

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

Например:
- если 1-ый день месяца является понедельником, неделя, которую каждый запускает на 1-ом и нет никакого недельного нуля
- если 2-ой день месяца является понедельником, неделей, которую каждый запускает на 2-ом, и 1-ое находится в недельном нуле
- если 4-ый день месяца является понедельником, неделей, которую каждый запускает на 4-ом, и 1-ое к 3-ьему находится в недельном нуле
- если 5-ый день месяца является понедельником, неделя два запускается на 5-ом, и 1-ое к 4-ому находится на неделе один

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

Возвраты:

полевой доступ обеспечения к неделе-месячного, не нуль

weekOfYear

public TemporalField weekOfYear()

Возвращает поле, чтобы получить доступ к неделе года, основанного на этом WeekFields.

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

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

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

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

Возвраты:

полевой доступ обеспечения к неделе-летнего, не нуль

weekOfWeekBasedYear

public TemporalField weekOfWeekBasedYear()

Возвращает поле, чтобы получить доступ к неделе "недели базируемый год", основанный на этом WeekFields.

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

Неделя каждый - неделя, запускающаяся на getFirstDayOfWeek() где есть, по крайней мере, getMinimalDaysInFirstWeek() дни в году. Если первая неделя запускается после запуска года тогда период прежде находится на прошлой неделе предыдущего года.

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

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

Возвраты:

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

weekBasedYear

public TemporalField weekBasedYear()

Возвращает поле, чтобы получить доступ к году "недели базируемый год", основанный на этом WeekFields.

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

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

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

Возвраты:

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

равняется

public boolean equals(Object object)

Проверки, если это WeekFields равно указанному объекту.

Сравнение основано на всем состоянии правил, которое является первым днем-недельного и минимальными днями.

Переопределения:

equals в class Object

Параметры:

object - другие правила сравниться с, нуль возвращает false

Возвраты:

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

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Хэш-код для этого WeekFields.

Переопределения:

hashCode в class Object

Возвраты:

подходящий хэш-код

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Строковое представление этого WeekFields экземпляр.

Переопределения:

toString в class Object

Возвраты:

строковое представление, не нуль