Перечисление DayOfWeek

public static final DayOfWeek MONDAY

Единственный экземпляр для понедельника. Его числовое значение — 1.

public static final DayOfWeek TUESDAY

Единственный экземпляр для вторника. Его числовое значение — 2.

public static final DayOfWeek WEDNESDAY

Единственный экземпляр для среды. Его числовое значение — 3.

public static final DayOfWeek THURSDAY

Единственный экземпляр для четверга. Его числовое значение — 4.

public static final DayOfWeek FRIDAY

Единственный экземпляр для пятницы. Его числовое значение — 5.

public static final DayOfWeek SATURDAY

Единственный экземпляр для субботы. Его числовое значение — 6.

public static final DayOfWeek SUNDAY

Единственный экземпляр для воскресенья. Его числовое значение — 7.

public static DayOfWeek[] values()

Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

public static DayOfWeek valueOf(String name)

Возвращает константу перечисления этого класса с указанным именем. Строка должна точно совпадать с идентификатором, использованным для объявления константы перечисления в этом классе. (Лишние пробелы не допускаются.)

public static DayOfWeek of(int dayOfWeek)

Получает экземпляр DayOfWeek из значения int.

DayOfWeek — это перечисление, представляющее 7 дней недели. Этот метод-фабрика позволяет получить элемент перечисления по значению int. Значение int соответствует стандарту ISO-8601: от 1 (понедельник) до 7 (воскресенье).

public static DayOfWeek from(TemporalAccessor temporal)

Получает экземпляр DayOfWeek из объекта временных данных.

Метод получает день недели на основе указанных временных данных. TemporalAccessor представляет произвольный набор сведений о дате и времени, который этот метод-фабрика преобразует в экземпляр DayOfWeek.

Преобразование извлекает поле DAY_OF_WEEK.

Сигнатура этого метода соответствует функциональному интерфейсу TemporalQuery, что позволяет использовать его в качестве запроса посредством ссылки на метод: DayOfWeek::from.

public int getValue()

Получает int-значение дня недели.

Значения пронумерованы согласно стандарту ISO-8601: от 1 (понедельник) до 7 (воскресенье). Информацию о локализованной нумерации недель см. в разделе WeekFields.dayOfWeek().

public String getDisplayName(TextStyle style, Locale locale)

Получает текстовое представление, например «Mon» или «Friday».

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

Если текстовое соответствие не найдено, возвращается numeric value.

public boolean isSupported(TemporalField field)

Проверяет, поддерживается ли указанное поле.

Метод проверяет, можно ли запросить у этого дня недели значение указанного поля. Если метод возвращает false, вызов методов range и get приведет к выбросу исключения.

Для поля DAY_OF_WEEK этот метод возвращает true. Для всех остальных экземпляров ChronoField возвращается false.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.isSupportedBy(TemporalAccessor) с передачей this в качестве аргумента. Поддержка поля определяется самим полем.

public ValueRange range(TemporalField field)

Получает диапазон допустимых значений указанного поля.

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

Для поля DAY_OF_WEEK возвращается диапазон дней недели от 1 до 7. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.rangeRefinedBy(TemporalAccessor) с передачей this в качестве аргумента. Возможность получить диапазон определяется самим полем.

public int get(TemporalField field)

Получает значение указанного поля для этого дня недели в виде int.

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

Для поля DAY_OF_WEEK возвращается значение дня недели от 1 до 7. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.getFrom(TemporalAccessor) с передачей this в качестве аргумента. Возможность получить значение и его смысл определяются самим полем.

public long getLong(TemporalField field)

Получает значение указанного поля для этого дня недели в виде long.

Метод запрашивает у этого дня недели значение указанного поля. Если вернуть значение невозможно из-за неподдерживаемого поля или по иной причине, выбрасывается исключение.

Для поля DAY_OF_WEEK возвращается значение дня недели от 1 до 7. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.getFrom(TemporalAccessor) с передачей this в качестве аргумента. Возможность получить значение и его смысл определяются самим полем.

public DayOfWeek plus(long days)

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

При вычислении переход через конец недели выполняется от воскресенья к понедельнику. Указанный период может быть отрицательным.

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

public DayOfWeek minus(long days)

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

При вычислении переход через начало недели выполняется от понедельника к воскресенью. Указанный период может быть отрицательным.

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

public <R> R query(TemporalQuery<R> query)

Выполняет запрос к этому дню недели с помощью указанного запроса.

Метод выполняет запрос к этому дню недели с помощью указанного объекта стратегии запроса. Объект TemporalQuery определяет логику получения результата. Чтобы понять, каким будет результат этого метода, ознакомьтесь с документацией запроса.

Результат этого метода получается вызовом метода TemporalQuery.queryFrom(TemporalAccessor) для указанного запроса с передачей this в качестве аргумента.

public Temporal adjustInto(Temporal temporal)

Изменяет указанный объект временных данных так, чтобы он соответствовал этому дню недели.

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

Корректировка эквивалентна использованию Temporal.with(TemporalField, long) с передачей ChronoField.DAY_OF_WEEK в качестве поля. Обратите внимание, что корректировка выполняется вперед или назад в пределах недели с понедельника по воскресенье. Информацию о локализованных днях начала недели см. в разделе WeekFields.dayOfWeek(). Другие корректировщики с более широкими возможностями, например next(MONDAY), см. в разделе TemporalAdjuster.

В большинстве случаев код будет понятнее, если изменить порядок вызова и использовать Temporal.with(TemporalAdjuster):

  // these two lines are equivalent, but the second approach is recommended
  temporal = thisDayOfWeek.adjustInto(temporal);
  temporal = temporal.with(thisDayOfWeek);

Например, если задана дата, приходящаяся на среду, будут выведены следующие результаты:

  dateOnWed.with(MONDAY);     // two days earlier
  dateOnWed.with(TUESDAY);    // one day earlier
  dateOnWed.with(WEDNESDAY);  // same date
  dateOnWed.with(THURSDAY);   // one day later
  dateOnWed.with(FRIDAY);     // two days later
  dateOnWed.with(SATURDAY);   // three days later
  dateOnWed.with(SUNDAY);     // four days later

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