Month (Java Platform SE 8 )

java.lang.Object
- java.lang.Enum<Month>
- - java.time.Month

All Implemented Interfaces:

Serializable， Comparable < Month >， TemporalAccessor， TemporalAdjuster
```
public enum Month
extends Enum<Month>
implements TemporalAccessor, TemporalAdjuster
```
一年一个月，如“七月”。
Month是代表一年12个月至一月，二月，三月，枚举，四月，五月，六月，七月，八月，九月，十月，十一月和十二月。

除了文本枚举的名称，每个月有一年int价值。int值以下的正常使用和ISO-8601标准，从1（一月）到12（十二月）。建议应用程序使用枚举，而不是确保代码清晰的int价值。

不要使用ordinal()获得Month的数字表示法。使用getValue()相反。

这个枚举代表一个共同的概念，在许多日历系统。因此，此类型可以由具有年概念定义完全等同于ISO-8601日历系统月的日历系统。

实现要求：

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

从以下版本开始：

一点八

Enum Constant Summary

Enum Constants
Enum Constant and Description
`APRIL` 以30天为四月的单例实例。
`AUGUST` 8月的单例实例，用31天。
`DECEMBER` 以31天为十二月的单例实例。
`FEBRUARY` 单例为二月，28天，或29在一个飞跃的一个月。
`JANUARY` 以31天为一月的单例实例。
`JULY` 以31天为七月的单例实例。
`JUNE` 以30天为六月的单例实例。
`MARCH` 3月用31天的单例实例。
`MAY` 5月份的单例实例，用31天。
`NOVEMBER` 以30天为十一月的单例实例。
`OCTOBER` 以31天为十月的单例实例。
`SEPTEMBER` 以30天为九月的单例实例。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`Temporal`	`adjustInto(Temporal temporal)` 调整指定的时间对象有这个月的一年。
`int`	`firstDayOfYear(boolean leapYear)` 获取本月第一天对应的一年的一天。
`Month`	`firstMonthOfQuarter()` 获取对应于本季度第一个月的月份。
`static Month`	`from(TemporalAccessor temporal)` 获得 `Month`实例从一个时空对象。
`int`	`get(TemporalField field)` 获取指定字段的值，从这个月的一年 `int`。
`String`	`getDisplayName(TextStyle style, Locale locale)` 获取文本表示形式，如“简”或“十二月”。
`long`	`getLong(TemporalField field)` 获取指定字段的值，从这个月的一 `long`。
`int`	`getValue()` 获取 `int`价值年月。
`boolean`	`isSupported(TemporalField field)` 检查指定字段是否被支持。
`int`	`length(boolean leapYear)` 获取本月的长度。
`int`	`maxLength()` 获取这个月的最大长度。
`int`	`minLength()` 获取这个月的最小长度。
`Month`	`minus(long months)` 返回一年的月，是在这一个之前指定的数月。
`static Month`	`of(int month)` 获得 `Month`实例从一个 `int`价值。
`Month`	`plus(long months)` 返回一年的月，是指定数量的后，这一个。
`<R> R`	`query(TemporalQuery<R> query)` 使用指定的查询使用一年的查询。
`ValueRange`	`range(TemporalField field)` 获取指定字段的有效值的范围。
`static Month`	`valueOf(String name)` 返回此类型具有指定名称的枚举常量。
`static Month[]`	`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
  - JANUARY
```
public static final Month JANUARY
```
    以31天为一月的单例实例。这有 1数值。
  - FEBRUARY
```
public static final Month FEBRUARY
```
    单例为二月，28天，或29在一个飞跃的一个月。这有 2数值。
  - MARCH
```
public static final Month MARCH
```
    3月用31天的单例实例。这有 3数值。
  - APRIL
```
public static final Month APRIL
```
    以30天为四月的单例实例。这有 4数值。
  - MAY
```
public static final Month MAY
```
    5月份的单例实例，用31天。这有 5数值。
  - JUNE
```
public static final Month JUNE
```
    以30天为六月的单例实例。这有 6数值。
  - JULY
```
public static final Month JULY
```
    以31天为七月的单例实例。这有 7数值。
  - AUGUST
```
public static final Month AUGUST
```
    8月的单例实例，用31天。这有 8数值。
  - SEPTEMBER
```
public static final Month SEPTEMBER
```
    以30天为九月的单例实例。这有 9数值。
  - OCTOBER
```
public static final Month OCTOBER
```
    以31天为十月的单例实例。这有 10数值。
  - NOVEMBER
```
public static final Month NOVEMBER
```
    以30天为十一月的单例实例。这有 11数值。
  - DECEMBER
```
public static final Month DECEMBER
```
    以31天为十二月的单例实例。这有 12数值。
- 方法详细信息
  - values
```
public static Month[] values()
```
    返回一个数组包含该枚举类型的常量，它们的顺序声明。这种方法可以用来遍历常数如下：
```
为（月C：月。values()） 系统，println（C）；
```
    结果
    
    这个数组包含枚举类型的常量，它们的顺序声明
  - valueOf
```
public static Month valueOf(String name)
```
    返回此类型具有指定名称的枚举常量。字符串必须匹配确切地用来声明一个枚举本型常数标识符。（多余空格的字符是不允许的。）
    
    参数
    
    name -定要返回的枚举的名称。
    
    结果
    
    具有指定名称的枚举常量
    
    异常
    
    IllegalArgumentException -如果这个枚举类型，也没有固定的具有指定名称
    
    NullPointerException -如果参数为空
  - of
```
public static Month of(int month)
```
    获得 Month实例从一个 int价值。
    Month代表一年的12个月的枚举。本厂允许枚举是从int值。的int价值遵循ISO-8601标准，从1（一月）到12（十二月）。
    
    参数
    
    month -年月为代表，从1（一月）到12（十二月）
    
    结果
    
    一年中的一个月，而不是零
    
    异常
    
    DateTimeException如果今年月无效
  - from
```
public static Month from(TemporalAccessor temporal)
```
    获得 Month实例从一个时空对象。
    这获得一个月的基础上指定的时间。一个TemporalAccessor表示日期和时间信息，任意设置，本厂将以Month实例。
    
    转换提取MONTH_OF_YEAR场。提取只允许如果时空对象有一个ISO年表，或可以转换为一个LocalDate。
    
    这种方法相匹配的功能接口TemporalQuery可以通过方法引用查询中的签名，Month::from。
    
    参数
    
    temporal -转换时间的对象，不为空
    
    结果
    
    一年中的一个月，而不是零
    
    异常
    
    DateTimeException如果无法转换为 Month
  - getValue
```
public int getValue()
```
    获取 int价值年月。
    价值观是继ISO-8601标准编号，从1（一月）到12（十二月）。
    
    结果
    
    一年一个月，从1（一月）至12（十二月）
  - getDisplayName
```
public String getDisplayName(TextStyle style,
                             Locale locale)
```
    获取文本表示形式，如“简”或“十二月”。
    此返回用于标识一年中的月份的文本名称，适用于向用户演示文稿。参数控制返回的文本和区域设置的样式。
    
    如果没有文本映射找到那么numeric value返回。
    
    参数
    
    style -文本所需要的长度，不空
    
    locale -现场使用，不为空
    
    结果
    
    一年中的文本值，不是空的
  - isSupported
```
public boolean isSupported(TemporalField field)
```
    检查指定字段是否被支持。
    如果这个月的一年可以查询指定的字段。如果为false，则调用range和get方法将抛出一个异常。
    
    如果该字段是MONTH_OF_YEAR那么这个方法返回true。所有其他ChronoField实例将返回false。
    
    如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.isSupportedBy(TemporalAccessor)得到此方法的结果。是否支持字段由字段确定。
    
    Specified by:
    
    isSupported 接口 TemporalAccessor
    
    参数
    
    field -现场检查null返回false
    
    结果
    
    如果在本月的一年，假，如果没有的话，是真的
  - range
```
public ValueRange range(TemporalField field)
```
    获取指定字段的有效值的范围。
    该范围对象表示字段的最小值和最大有效值。这个月是用来提高返回范围的准确性。如果它是不可能返回的范围，因为字段不支持或其他一些原因，抛出一个异常。
    
    如果该字段是MONTH_OF_YEAR然后今年月的范围，从1到12，将返回。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。
    
    如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.rangeRefinedBy(TemporalAccessor)得到此方法的结果。是否可以得到范围是由字段确定的。
    
    Specified by:
    
    range 接口 TemporalAccessor
    
    参数
    
    field -现场查询范围，不为空
    
    结果
    
    字段的有效值的范围，而不是空值
    
    异常
    
    DateTimeException如果不能得到的领域范围
    
    UnsupportedTemporalTypeException如果字段不支持
  - get
```
public int get(TemporalField field)
```
    获取指定字段的值，从这个月的一年 int。
    此查询本月为指定字段的值。返回的值将始终在字段的有效值范围内。如果不可能返回值，因为字段不支持或其他原因，则抛出异常。
    
    如果该字段是MONTH_OF_YEAR然后今年月值，从1到12，将返回。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。
    
    如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.getFrom(TemporalAccessor)得到此方法的结果。是否可以得到值，以及值表示的值，由字段确定。
    
    Specified by:
    
    get 接口 TemporalAccessor
    
    参数
    
    field -领域有，不空
    
    结果
    
    字段的值，在有效值范围内
    
    异常
    
    DateTimeException如果字段的值是不能获得或值不在字段的有效值范围内
    
    UnsupportedTemporalTypeException -如果字段不支持或值的范围超过一个 int
    
    ArithmeticException如果数值溢出时
  - getLong
```
public long getLong(TemporalField field)
```
    获取指定字段的值，从这个月的一 long。
    此查询本月为指定字段的值。如果不可能返回值，因为字段不支持或其他原因，则抛出异常。
    
    如果该字段是MONTH_OF_YEAR然后今年月值，从1到12，将返回。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。
    
    如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.getFrom(TemporalAccessor)得到此方法的结果。是否可以得到值，以及值表示的值，由字段确定。
    
    Specified by:
    
    getLong 接口 TemporalAccessor
    
    参数
    
    field -领域有，不空
    
    结果
    
    字段的值
    
    异常
    
    DateTimeException如果不能得到一个价值领域
    
    UnsupportedTemporalTypeException如果字段不支持
    
    ArithmeticException如果数值溢出时
  - plus
```
public Month plus(long months)
```
    返回一年的月，是指定数量的后，这一个。
    计算卷在年底的一年十二月至一月。指定的周期可能是负的。
    
    此实例是不可变的，不受此方法调用的影响。
    
    参数
    
    months -加个月，阳性或阴性
    
    结果
    
    由此产生的一个月，不是空
  - minus
```
public Month minus(long months)
```
    返回一年的月，是在这一个之前指定的数月。
    计算卷在一年的开始，从一月到十二月。指定的周期可能是负的。
    
    此实例是不可变的，不受此方法调用的影响。
    
    参数
    
    months -减去月，阳性或阴性
    
    结果
    
    由此产生的一个月，不是空
  - length
```
public int length(boolean leapYear)
```
    获取本月的长度。
    这需要一个标志，以确定是否返回的长度为一个跳跃的一年或不。
    
    二月有一个标准的一年29天，在一个跨越28天。四月、六月、九月和十一月有30天。所有其他月有31天。
    
    参数
    
    leapYear -如果长度是闰年的要求
    
    结果
    
    这个月的长度在几天，从28到31
  - minLength
```
public int minLength()
```
    获取这个月的最小长度。
    二月的最小长度为28天。四月、六月、九月和十一月有30天。所有其他月有31天。
    
    结果
    
    本月最低日数，从28日至31日
  - maxLength
```
public int maxLength()
```
    获取这个月的最大长度。
    二月有一个最大长度为29天。四月、六月、九月和十一月有30天。所有其他月有31天。
    
    结果
    
    这个月的最大长度在几天，从29到31
  - firstDayOfYear
```
public int firstDayOfYear(boolean leapYear)
```
    获取本月第一天对应的一年的一天。
    这将返回本月开始的一年的一天，使用“跨越”标志，以确定二月的长度。
    
    参数
    
    leapYear -如果长度是闰年的要求
    
    结果
    
    本月第一天对应的一天，从1日至336日
  - firstMonthOfQuarter
```
public Month firstMonthOfQuarter()
```
    获取对应于本季度第一个月的月份。
    一年可分为四个季度。此方法返回的第一个月的季度为基准月。二月、一月和3月回归一月。四月、5月和六月回归四月。七月、8月和九月回归七月。十月、十一月和十二月回归十月。
    
    结果
    
    本季度第一个月对应这个月，不是空
  - 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.MONTH_OF_YEAR作为现场。如果指定的时间对象不使用ISO的日历系统，然后DateTimeException抛出。
    
    在大多数情况下，更清晰的用Temporal.with(TemporalAdjuster)反向调用模式：
```
这两条线是等价的，但第二种方法是建议时间=月adjustinto（时间）；时间=（月）与时间；
```
    例如，在5月给定一个日期，以下是输出：
```
dateinmay，（一月）；//四个月前dateinmay，（四月）；/ /一个月前dateinmay，（可能）；/ /同一日期dateinmay，（六月）；//一个月后dateinmay，（十二月）；//七个月后
```
    此实例是不可变的，不受此方法调用的影响。
    Specified by:
    
    adjustInto 接口 TemporalAdjuster
    
    参数
    
    temporal -调整目标对象，不为空
    
    结果
    
    调整后的对象，而不是空
    
    异常
    
    DateTimeException如果无法适应
    
    ArithmeticException如果数值溢出时

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Enum Month

Enum Constant Summary

方法摘要

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

JANUARY

FEBRUARY

MARCH

APRIL

MAY

JUNE

JULY

AUGUST

SEPTEMBER

OCTOBER

NOVEMBER

DECEMBER

方法详细信息

values

valueOf

of

from

getValue

getDisplayName

isSupported

range

get

getLong

plus

minus

length

minLength

maxLength

firstDayOfYear

firstMonthOfQuarter

query

adjustInto