compact1, compact2, compact3

java.time

Enum DayOfWeek

java.lang.Object

java.lang.Enum<DayOfWeek>

java.time.DayOfWeek

All Implemented Interfaces:

Serializable， Comparable < DayOfWeek >， TemporalAccessor， TemporalAdjuster

public enum DayOfWeek
extends Enum<DayOfWeek>
implements TemporalAccessor, TemporalAdjuster

一周的一天，如“星期二”。

DayOfWeek代表一周的7天，星期一，星期二，星期三，星期四，星期五，星期六和星期日的枚举。

除了文本枚举名称，周的每一天都有一个int价值。的int价值遵循ISO-8601标准，从1（星期一）7（星期日）。建议应用程序使用枚举，而不是确保代码清晰的int价值。

这个枚举提供本地化的文本形式的星期几。有些地方还赋予不同的数值的时候，宣布星期日有价值的1，然而这类没有提供支持这。看到WeekFields局部周编号。

不要使用ordinal()获得DayOfWeek数字表示使用getValue()代替。

这个枚举代表一个共同的概念，在许多日历系统。因此，此类型可用于任何日历系统，有星期的概念定义完全等同于ISO的日历系统。

实现要求：

这是一个不变的线程安全的枚举。

从以下版本开始：

一点八

Enum Constant Summary

Enum Constants

Enum Constant and Description
FRIDAY 星期五的一周的单例实例。
MONDAY 星期一的一周的单例实例。
SATURDAY 星期六的一周的单例实例。
SUNDAY 星期日的一周的单例实例。
THURSDAY 星期四的一周的单例实例。
TUESDAY 星期二的一周的单例实例。
WEDNESDAY 星期三的一周的单例实例。

方法摘要

Modifier and Type	Method and Description
Temporal	adjustInto(Temporal temporal) 调整指定的时间对象有一周的这一天。
static DayOfWeek	from(TemporalAccessor temporal) 获得 DayOfWeek实例从一个时空对象。
int	get(TemporalField field) 获取指定字段的值，从这个星期的 int。
String	getDisplayName(TextStyle style, Locale locale) 获取文本表示形式，如“星期一”或“星期五”。
long	getLong(TemporalField field) 获取指定字段的值，从这一天开始，一周 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() 返回一个数组包含该枚举类型的常量，它们的顺序声明。

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

MONDAY

public static final DayOfWeek MONDAY

星期一的一周的单例实例。这有 1数值。

TUESDAY

public static final DayOfWeek TUESDAY

星期二的一周的单例实例。这有 2数值。

WEDNESDAY

public static final DayOfWeek WEDNESDAY

星期三的一周的单例实例。这有 3数值。

THURSDAY

public static final DayOfWeek THURSDAY

星期四的一周的单例实例。这有 4数值。

FRIDAY

public static final DayOfWeek FRIDAY

星期五的一周的单例实例。这有 5数值。

SATURDAY

public static final DayOfWeek SATURDAY

星期六的一周的单例实例。这有 6数值。

SUNDAY

public static final DayOfWeek SUNDAY

星期日的一周的单例实例。这有 7数值。

方法详细信息

values

public static DayOfWeek[] values()

返回一个数组包含该枚举类型的常量，它们的顺序声明。这种方法可以用来遍历常数如下：

为（C：周周。values()） 系统，println（C）；

结果

这个数组包含枚举类型的常量，它们的顺序声明

valueOf

public static DayOfWeek valueOf(String name)

返回此类型具有指定名称的枚举常量。字符串必须匹配确切地用来声明一个枚举本型常数标识符。（多余空格的字符是不允许的。）

参数

name -定要返回的枚举的名称。

结果

具有指定名称的枚举常量

异常

IllegalArgumentException -如果这个枚举类型，也没有固定的具有指定名称

NullPointerException -如果参数为空

of

public static DayOfWeek of(int dayOfWeek)

获得 DayOfWeek实例从一个 int价值。

DayOfWeek代表一周的7天，一个枚举。本厂允许枚举是从int值。的int价值遵循ISO-8601标准，从1（星期一）7（星期日）。

参数

dayOfWeek -周代表天，1（星期一）7（星期日）

结果

一周的单身，不是空的

异常

DateTimeException如果星期无效

from

public static DayOfWeek from(TemporalAccessor temporal)

获得 DayOfWeek实例从一个时空对象。

这得到一个星期的基础上指定的时间。一个TemporalAccessor表示日期和时间信息，任意设置，本厂将以DayOfWeek实例。

转换提取DAY_OF_WEEK场。

该方法的签名匹配的功能接口TemporalQuery可以通过方法参考查询，DayOfWeek::from。

参数

temporal -转换时间的对象，不为空

结果

星期的一天，不是空的

异常

DateTimeException如果无法转换为 DayOfWeek

getValue

public int getValue()

得到周 int价值的一天。

价值观是继ISO-8601标准编号，从1（星期一）7（星期日）。看到WeekFields.dayOfWeek局部周编号。

结果

一周的一天，从1（星期一）到7（星期日）

getDisplayName

public String getDisplayName(TextStyle style,
                             Locale locale)

获取文本表示形式，如“星期一”或“星期五”。

这返回用于标识一周的一天的文本名称，适用于向用户演示文稿。参数控制返回的文本和区域设置的样式。

如果没有文本映射找到那么numeric value返回。

参数

style -文本所需要的长度，不空

locale -现场使用，不为空

结果

星期的一天的文本值，不是空的

isSupported

public boolean isSupported(TemporalField field)

检查指定字段是否被支持。

如果这一周的这一天可以查询指定的字段。如果为false，则调用range和get方法将抛出一个异常。

如果该字段是DAY_OF_WEEK那么这个方法返回true。所有其他ChronoField实例将返回false。

如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.isSupportedBy(TemporalAccessor)得到此方法的结果。是否支持字段由字段确定。

Specified by:

isSupported 接口 TemporalAccessor

参数

field -现场检查null返回false

结果

如果在一周的这一天被支持，如果不支持的话

range

public ValueRange range(TemporalField field)

获取指定字段的有效值的范围。

该范围对象表示字段的最小值和最大有效值。这一周的一天是用来提高返回范围的准确性。如果它是不可能返回的范围，因为字段不支持或其他一些原因，抛出一个异常。

如果该字段是DAY_OF_WEEK然后星期几的范围，从1到7，将返回。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。

如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.rangeRefinedBy(TemporalAccessor)得到此方法的结果。是否可以得到范围是由字段确定的。

Specified by:

range 接口 TemporalAccessor

参数

field -现场查询范围，不为空

结果

字段的有效值的范围，而不是空值

异常

DateTimeException如果不能得到的领域范围

UnsupportedTemporalTypeException如果字段不支持

get

public int get(TemporalField field)

获取指定字段的值，从这个星期的 int。

此查询为指定字段的值的这一周。返回的值将始终在字段的有效值范围内。如果不可能返回值，因为字段不支持或其他原因，则抛出异常。

如果该字段是DAY_OF_WEEK然后星期几的值，从1到7，将返回。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。

如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.getFrom(TemporalAccessor)得到此方法的结果。是否可以得到值，以及值表示的值，由字段确定。

Specified by:

get 接口 TemporalAccessor

参数

field -领域有，不空

结果

字段的值，在有效值范围内

异常

DateTimeException如果字段的值是不能获得或值不在字段的有效值范围内

UnsupportedTemporalTypeException -如果字段不支持或值的范围超过一个 int

ArithmeticException如果数值溢出时

getLong

public long getLong(TemporalField field)

获取指定字段的值，从这一天开始，一周

此查询为指定字段的值的这一周。如果不可能返回值，因为字段不支持或其他原因，则抛出异常。

如果该字段是DAY_OF_WEEK然后星期几的值，从1到7，将返回。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。

如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.getFrom(TemporalAccessor)得到此方法的结果。是否可以得到值，以及值表示的值，由字段确定。

long。

Specified by:

getLong 接口 TemporalAccessor

参数

field -领域有，不空

结果

字段的值

异常

DateTimeException如果不能得到一个价值领域

UnsupportedTemporalTypeException如果字段不支持

ArithmeticException如果数值溢出时

plus

public DayOfWeek plus(long days)

返回一周的那一天，是这一个之后的指定天数。

计算卷从星期日到星期一的一周结束。指定的周期可能是负的。

此实例是不可变的，不受此方法调用的影响。

参数

days -加天，阳性或阴性

结果

产生的一天一周，而不是零

minus

public DayOfWeek minus(long days)

返回一周的一天，是在这一天之前指定的天数。

计算卷在一年的开始，从星期一到星期日。指定的周期可能是负的。

此实例是不可变的，不受此方法调用的影响。

参数

days -减去天，阳性或阴性

结果

产生的一天一周，而不是零

query

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

使用指定的查询使用本周的查询。

此查询使用指定的查询策略对象使用本周的这一天。的TemporalQuery对象定义了用来获得结果的逻辑。阅读查询的文档，了解该方法的结果将是什么。

这种方法的结果是通过调用指定的查询通过this作为论据的TemporalQuery.queryFrom(TemporalAccessor)方法得到的。

Specified by:

query 接口 TemporalAccessor

参数类型

R -结果的类型

参数

query -调用查询，不空

结果

查询结果，可以返回（由查询所定义）

异常

DateTimeException如果无法查询（查询所定义）

ArithmeticException如果数值溢出时（由查询定义）

adjustInto

public Temporal adjustInto(Temporal temporal)

调整指定的时间对象有一周的这一天。

这返回一个相同的可观察类型的时间对象的输入与一周的时间改变，这是相同的。

调整是相当于用Temporal.with(TemporalField, long)传递ChronoField.DAY_OF_WEEK作为现场。请注意，这调整向前或向后在一个星期一至星期日周。看到局部周开始的日子WeekFields.dayOfWeek。更多的控制TemporalAdjuster看到其他的调节，如next(MONDAY)。

在大多数情况下，更清晰的用Temporal.with(TemporalAdjuster)反向调用模式：

这两条线是等价的，但第二种方法是建议时间= thisdayofweek adjustinto（时间）；时间=（thisdayofweek）与时间；

例如，给定一个日期，是一个星期三，以下是输出：

dateonwed，（星期一）；//两天前dateonwed，（星期二）；/ /早一天dateonwed，（星期三）；/ /同一日期dateonwed，（星期四）；/ /一天dateonwed，（星期五）；//两天后dateonwed，（星期六）；/ /三天后dateonwed，（星期日）；/ /四天后

此实例是不可变的，不受此方法调用的影响。

Specified by:

adjustInto 接口 TemporalAdjuster

参数

temporal -调整目标对象，不为空

结果

调整后的对象，而不是空

异常

DateTimeException如果无法适应

ArithmeticException如果数值溢出时