Spec-Zone .ru
спецификации, руководства, описания, API
|
public enum DayOfWeek extends Enum<DayOfWeek> implements TemporalAccessor, TemporalAdjuster
DayOfWeek
перечисление, представляющее 7 дней недели - в понедельник, во вторник, в среду, в четверг, в пятницу, в субботу и в воскресенье.
В дополнение к текстовому перечислимому имени каждый день-недельного имеет int
значение. int
значение следует за стандартом ISO 8601, от 1 (понедельник) к 7 (воскресенье). Рекомендуется, чтобы приложения использовали перечисление, а не int
значение, чтобы гарантировать ясность кода.
Это перечисление обеспечивает доступ к локализованной текстовой форме дня-недельного. Некоторые локали также присваивают различные числовые значения дням, объявляя в воскресенье, чтобы иметь значение 1, однако этот class не оказывает поддержки для этого. См. WeekFields
для локализованной нумерации недели.
Не использовать ordinal()
получить числовое представление DayOfWeek
. Использовать getValue()
вместо этого.
Это перечисление представляет общее понятие, которое находится во многих календарных системах. Также, это перечисление может использоваться любой календарной системой, которой определили дневное-недельного понятие, точно эквивалентное календарной системе ISO.
Перечислимая Константа и Описание |
---|
В ПЯТНИЦУ
Одноэлементный экземпляр в течение дня-недельного пятницы.
|
В ПОНЕДЕЛЬНИК
Одноэлементный экземпляр в течение дня-недельного понедельника.
|
В СУББОТУ
Одноэлементный экземпляр в течение дня-недельного субботы.
|
В ВОСКРЕСЕНЬЕ
Одноэлементный экземпляр в течение дня-недельного воскресенья.
|
В ЧЕТВЕРГ
Одноэлементный экземпляр в течение дня-недельного четверга.
|
ВО ВТОРНИК
Одноэлементный экземпляр в течение дня-недельного вторника.
|
В СРЕДУ
Одноэлементный экземпляр в течение дня-недельного среды.
|
Модификатор и Тип | Метод и Описание |
---|---|
Временный |
adjustInto(Temporal temporal)
Корректирует указанный временный объект иметь в этот день-недельного.
|
static DayOfWeek |
from(TemporalAccessor temporal)
Получает экземпляр
DayOfWeek от временного объекта. |
int |
get(TemporalField field)
Получает значение указанного поля с этого дня-недельного как
int . |
Строка |
getDisplayName(TextStyle style, Locale locale)
Получает текстовое представление, такое как 'понедельник' или в 'пятницу'.
|
long |
getLong(TemporalField field)
Получает значение указанного поля с этого дня-недельного как a
long . |
int |
getValue()
Получает день-недельного
int значение. |
boolean |
isSupported(TemporalField field)
Проверки, если указанное поле поддерживается.
|
DayOfWeek |
minus(long days)
Возвращает день-недельного, который является конкретным количеством дней перед этим.
|
static DayOfWeek |
of(int dayOfWeek)
Получает экземпляр
DayOfWeek от int значение. |
DayOfWeek |
plus(long days)
Возвращает день-недельного, который является конкретным количеством дней после этого.
|
<R> R |
query(TemporalQuery<R> query)
Запросы в этот день-недельного, используя указанный запрос.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
static DayOfWeek |
valueOf(String name)
Возвращает перечислимую константу этого типа с указанным именем.
|
static DayOfWeek[] |
values()
Возвращает массив, содержащий константы этого перечислимого типа, в порядке, которым они объявляются.
|
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
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()
for (DayOfWeek c : DayOfWeek.values()) System.out.println(c);
public static DayOfWeek valueOf(String name)
name
- имя перечислимой константы, которая будет возвращена.IllegalArgumentException
- если у этого перечислимого типа нет никакой константы с указанным именемNullPointerException
- если параметром является нульpublic static DayOfWeek of(int dayOfWeek)
DayOfWeek
от int
значение.
DayOfWeek
перечисление, представляющее 7 дней недели. Эта фабрика позволяет перечислению быть полученным из int
значение. int
значение следует за стандартом ISO 8601, от 1 (понедельник) к 7 (воскресенье).
dayOfWeek
- день-недельного, чтобы представить, от 1 (понедельник) к 7 (воскресенье)DateTimeException
- если день-недельного недопустимpublic static DayOfWeek from(TemporalAccessor temporal)
DayOfWeek
от временного объекта. Это получает день-недельного, основанный на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр DayOfWeek
.
Преобразование извлекает DAY_OF_WEEK
поле.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, DayOfWeek::from
.
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a DayOfWeek
public int getValue()
int
значение. Значения нумеруются после стандарта ISO 8601, от 1 (понедельник) к 7 (воскресенье). См. WeekFields.dayOfWeek
для локализованной нумерации недели.
public String getDisplayName(TextStyle style, Locale locale)
Это возвращает текстовое имя, используемое, чтобы идентифицировать день-недельного, подходящий для представления пользователю. Параметры управляют стилем возвращенного текста и локали.
Если никакое текстовое отображение не находится тогда numeric value
возвращается.
style
- длина требуемого текста, не нульlocale
- локаль, чтобы использовать, не нульpublic boolean isSupported(TemporalField field)
Это проверяет, может ли этот день-недельного быть запрошен для указанного поля. Если ложь, то вызов range
и get
методы выдадут исключение.
Если поле DAY_OF_WEEK
тогда этот метод возвращает true. Все другой ChronoField
экземпляры возвратят false.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.isSupportedBy(TemporalAccessor)
передача this
как параметр. Поддерживается ли поле, определяется полем.
isSupported
в интерфейсе TemporalAccessor
field
- поле, чтобы проверить, обнулите, возвращает falsepublic ValueRange range(TemporalField field)
Объект диапазона выражает минимальные и максимальные допустимые значения для поля. Этот день-недельного используется, чтобы улучшить точность возвращенного диапазона. Если не возможно возвратить диапазон, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле DAY_OF_WEEK
тогда диапазон дня-недельного, от 1 до 7, будет возвращен. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.rangeRefinedBy(TemporalAccessor)
передача this
как параметр. Может ли диапазон быть получен, определяется полем.
range
в интерфейсе TemporalAccessor
field
- поле, чтобы запросить диапазон для, не нульDateTimeException
- если диапазон для поля не может быть полученUnsupportedTemporalTypeException
- если поле не поддерживаетсяpublic int get(TemporalField field)
int
. Это запрашивает в этот день-недельного для значения для указанного поля. Возвращенное значение всегда будет в пределах допустимого диапазона значений для поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле DAY_OF_WEEK
тогда значение дня-недельного, от 1 до 7, будет возвращено. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor)
передача this
как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
get
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульDateTimeException
- если значение для поля не может быть получено, или значение вне диапазона допустимых значений для поляUnsupportedTemporalTypeException
- если поле не поддерживается, или диапазон значений превышает int
ArithmeticException
- если числовое переполнение происходитpublic long getLong(TemporalField field)
long
. Это запрашивает в этот день-недельного для значения для указанного поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле DAY_OF_WEEK
тогда значение дня-недельного, от 1 до 7, будет возвращено. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor)
передача this
как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
getLong
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульDateTimeException
- если значение для поля не может быть полученоUnsupportedTemporalTypeException
- если поле не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic DayOfWeek plus(long days)
Вычисление катается вокруг конца недели с воскресенья до понедельника. Установленный период может быть отрицательным.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
days
- дни, чтобы добавить, положительный или отрицательныйpublic DayOfWeek minus(long days)
Вычисление катается вокруг запуска года с понедельника до воскресенья. Установленный период может быть отрицательным.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
days
- дни, чтобы вычесть, положительный или отрицательныйpublic <R> R query(TemporalQuery<R> query)
Это запрашивает в этот день-недельного, используя указанный объект стратегии запроса. TemporalQuery
объект определяет логику, которая будет использоваться, чтобы получить результат. Считайте документацию запроса, чтобы понять, каков результат этого метода будет.
Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor)
метод на указанной передаче запроса this
как параметр.
query
в интерфейсе TemporalAccessor
R
- тип результатаquery
- запрос, чтобы вызвать, не нульDateTimeException
- если неспособный запрашивать (определенный запросом)ArithmeticException
- если числовое переполнение происходит (определенный запросом)public Temporal adjustInto(Temporal temporal)
Это возвращает временный объект того же самого заметного типа как ввод со днем-недельного, измененным, чтобы быть тем же самым как этим.
Корректировка эквивалентна использованию Temporal.with(TemporalField, long)
передача ChronoField.DAY_OF_WEEK
как поле. Отметьте, что это корректируется вперед или назад в пределах понедельника к воскресной неделе. См. WeekFields.dayOfWeek
поскольку локализованная неделя запускает дни. См. TemporalAdjuster
для других регуляторов с большим количеством управления, такой как next(MONDAY)
.
В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании 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
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
adjustInto
в интерфейсе TemporalAdjuster
temporal
- целевой объект, который будет скорректирован, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходит
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92