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月，1月，2月，3月，4月，5月，6月，7月，8月，9月，10月，11月和12月的枚举。

除了文本枚举名称，每个月份的值都有一个int值。 int价格遵循正常使用和ISO-8601标准，从1月1日至12日（12月）。建议应用程序使用枚举而不是int值来确保代码清晰。

请勿使用ordinal()获取Month的数字Month 。 改用getValue() 。

该枚举代表了许多日历系统中发现的常见概念。因此，该枚举可能被任何具有与ISO-8601日历系统完全相同的年度概念的日历系统使用。

实现要求：

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

从以下版本开始：

1.8

Enum Constant Summary

Enum Constants
Enum Constant and Description
`APRIL` 4月份的单身实例，30天。
`AUGUST` 8月份的单身人士31天。
`DECEMBER` 12月份的单身人士31天。
`FEBRUARY` 二月份的单身人士28天，或闰年29人。
`JANUARY` 1月份的单身实例31天。
`JULY` 7月份的单身人士31天。
`JUNE` 6月份的单身人士30天。
`MARCH` 3月份的单身人士31天。
`MAY` 5月份的单身人士31天。
`NOVEMBER` 11月份的单身人士30天。
`OCTOBER` 10月份的单身人士31天。
`SEPTEMBER` 9月份的单身实例，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)` 获取文本表示，如“1月”或“12月”。
`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)` 从 `int`获取 `Month`一个实例。
`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
```
    1月份的单身实例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
```
    4月份的单身实例，30天。这个数值为4 。
  - MAY
```
public static final Month MAY
```
    5月份的单身人士31天。它的数值为5 。
  - JUNE
```
public static final Month JUNE
```
    6月份的单身人士30天。这个数值为6 。
  - JULY
```
public static final Month JULY
```
    7月份的单身人士31天。它的数值为7 。
  - AUGUST
```
public static final Month AUGUST
```
    8月份的单身人士31天。它的数值为8 。
  - SEPTEMBER
```
public static final Month SEPTEMBER
```
    9月份的单身实例，30天。这个数值为9 。
  - OCTOBER
```
public static final Month OCTOBER
```
    10月份的单身人士31天。它的数值为10 。
  - NOVEMBER
```
public static final Month NOVEMBER
```
    11月份的单身人士30天。这个数值为11 。
  - DECEMBER
```
public static final Month DECEMBER
```
    12月份的单身人士31天。它的数值为12 。
- 方法详细信息
  - values
```
public static Month[] values()
```
    按照它们声明的顺序返回一个包含此枚举类型常量的数组。该方法可用于遍历常量如下：
```
  for (Month c : Month.values())
    System.out.println(c); 
```
    结果
    
    一个包含这个枚举类型的常量的数组，按照它们被声明的顺序
  - valueOf
```
public static Month valueOf(String name)
```
    以指定的名称返回此类型的枚举常量。字符串必须完全匹配用于声明此类型的枚举常量的标识符。（不允许使用外来空白字符。）
    
    参数
    
    name - 要返回的枚举常量的名称。
    
    结果
    
    具有指定名称的枚举常数
    
    异常
    
    IllegalArgumentException - 如果此枚举类型没有指定名称的常量
    
    NullPointerException - 如果参数为空
  - of
```
public static Month of(int month)
```
    从int获取Month一个实例。
    Month是一年的12个月的枚举。该工厂允许从int获得枚举。 int价格遵循ISO-8601标准，从1月1日至12日（12月）。
    
    参数
    
    month - 从1月1日至12日（12月）的月份，
    
    结果
    
    月份，不为零
    
    异常
    
    DateTimeException - 如果月份无效
  - from
```
public static Month from(TemporalAccessor temporal)
```
    从时间对象获取一个Month的实例。
    这取决于指定时间的一个月。 A TemporalAccessor表示日期和时间信息的任意集合，该工厂将其转换为Month一个实例。
    
    该转换提取了MONTH_OF_YEAR字段。只有当时间对象具有ISO年表，或者可以转换为LocalDate时， LocalDate 。
    
    该方法中，功能接口的签名相匹配TemporalQuery允许它在通过方法参考，查询中使用Month::from 。
    
    参数
    
    temporal - 要转换的时间对象，不为null
    
    结果
    
    月份，不为零
    
    异常
    
    DateTimeException - 如果无法转换为 Month
  - getValue
```
public int getValue()
```
    获得年份int价值。
    这些值按照ISO-8601标准编号，从1（1月）到12（12月）。
    
    结果
    
    从1月（1月）到12月12日的月份
  - getDisplayName
```
public String getDisplayName(TextStyle style,
                             Locale locale)
```
    获取文本表示，如“1月”或“12月”。
    这将返回用于标识年月的文本名称，适合向用户呈现。参数控制返回的文本和区域设置的样式。
    
    如果没有发现文本映射，则返回numeric value 。
    
    参数
    
    style - 所需文本的长度，不为空
    
    locale - 要使用的语言环境，不为空
    
    结果
    
    月份的文本值不为空
  - isSupported
```
public boolean isSupported(TemporalField field)
```
    检查指定的字段是否受支持。
    这将检查是否可以查询指定字段的年月日。如果是false，那么调用range和get方法会抛出异常。
    
    如果该字段为MONTH_OF_YEAR，则此方法返回true。所有其他ChronoField实例将返回false。
    
    如果该字段是不是一个ChronoField ，则此方法的结果是通过调用获得TemporalField.isSupportedBy(TemporalAccessor)传递this作为参数。字段是否受支持由字段决定。
    
    Specified by:
    
    isSupported在界面 TemporalAccessor
    
    参数
    
    field - 要检查的字段，null返回false
    
    结果
    
    如果在这个月份的时候支持该字段，则为true，否则为false
  - range
```
public ValueRange range(TemporalField field)
```
    获取指定字段的有效值的范围。
    范围对象表示字段的最小和最大有效值。本月用于提高返回范围的准确性。如果不可能返回范围，因为该字段不受支持或出于某种其他原因，则抛出异常。
    
    如果该字段是MONTH_OF_YEAR ，则将返回从1到12的月份的范围。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException 。
    
    如果该字段是不是一个ChronoField ，则此方法的结果是通过调用获得TemporalField.rangeRefinedBy(TemporalAccessor)传递this作为参数。是否可以获得范围由字段确定。
    
    Specified by:
    
    range在接口 TemporalAccessor
    
    参数
    
    field - 查询范围的字段，不为null
    
    结果
    
    字段的有效值的范围不为null
    
    异常
    
    DateTimeException - 如果无法获取字段的范围
    
    UnsupportedTemporalTypeException - 如果该字段不被支持
  - get
```
public int get(TemporalField field)
```
    获取指定字段从这个月的年价值为int 。
    这个月查询指定字段的值。返回的值将始终在该字段的值的有效范围内。如果不可能返回值，因为该字段不受支持或出于某种其他原因，则抛出异常。
    
    如果字段为MONTH_OF_YEAR，那么将返回从1到12的月份的值。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException 。
    
    如果该字段是不是一个ChronoField ，则此方法的结果是通过调用获得TemporalField.getFrom(TemporalAccessor)传递this作为参数。该值是否可以获得，该值代表什么值由该字段决定。
    
    Specified by:
    
    get在界面 TemporalAccessor
    
    参数
    
    field - 要获取的字段，不为null
    
    结果
    
    该字段的值在值的有效范围内
    
    异常
    
    DateTimeException - 如果无法获取字段的值，或者该值超出了该字段的有效值的范围
    
    UnsupportedTemporalTypeException - 如果该字段不被支持或值范围超过 int
    
    ArithmeticException - 如果发生数字溢出
  - getLong
```
public long getLong(TemporalField field)
```
    从这个月份中获取指定字段的值为long 。
    这个月查询指定字段的值。如果不可能返回值，因为该字段不受支持或出于某种其他原因，则抛出异常。
    
    如果字段为MONTH_OF_YEAR，那么将返回从1到12的月份的值。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException 。
    
    如果该字段是不是一个ChronoField ，则此方法的结果是通过调用获得TemporalField.getFrom(TemporalAccessor)传递this作为参数。该值是否可以获得，该值代表什么值由该字段决定。
    
    Specified by:
    
    getLong在界面 TemporalAccessor
    
    参数
    
    field - 要获取的字段，不为null
    
    结果
    
    该字段的值
    
    异常
    
    DateTimeException - 如果无法获取该字段的值
    
    UnsupportedTemporalTypeException - 如果该字段不被支持
    
    ArithmeticException - 如果发生数字溢出
  - plus
```
public Month plus(long months)
```
    返回这个月之后指定的季度数。
    计算从12月到1月左右。指定期间可能为负。
    
    此实例是不可变的，不受此方法调用的影响。
    
    参数
    
    months - 增加的月份，正面或负面
    
    结果
    
    结果月份，不为空
  - minus
```
public Month minus(long months)
```
    返回指定月份之前的月份。
    计算从1月到12月的年初。指定期间可能为负。
    
    此实例是不可变的，不受此方法调用的影响。
    
    参数
    
    months - 减数，正或负的月数
    
    结果
    
    结果月份，不为空
  - length
```
public int length(boolean leapYear)
```
    以天为单位获得本月的长度。
    这需要一个标志来确定是否返回闰年的长度。
    
    二月份在标准年份有28天，闰年有29天。 4月，6月，9月和11月有30天。所有其他月份都有31天。
    
    参数
    
    leapYear - 如果闰年需要长度，则为true
    
    结果
    
    本月的天数为28天至31天
  - minLength
```
public int minLength()
```
    以天为单位获得本月的最小长度。
    二月最短28天。 4月，6月，9月和11月有30天。所有其他月份都有31天。
    
    结果
    
    这个月的最小长度为天数，从28到31
  - maxLength
```
public int maxLength()
```
    以天为单位获得本月的最大长度。
    二月最长可达29天。 4月，6月，9月和11月有30天。所有其他月份都有31天。
    
    结果
    
    这个月的最大长度为天，从29到31
  - firstDayOfYear
```
public int firstDayOfYear(boolean leapYear)
```
    获得与本月第一天对应的日期。
    这将返回本月开始的日期，使用闰年标志来确定2月的长度。
    
    参数
    
    leapYear - 如果闰年需要长度，则为true
    
    结果
    
    相当于本月第一天的一年中的一天，从1到336
  - firstMonthOfQuarter
```
public Month firstMonthOfQuarter()
```
    获得与本季度第一个月相对应的月份。
    年份可分为四个季度。此方法返回基准月份的季度的第一个月。 1月，2月和3月返回1月。四月，五月和六月返回四月。七月，八月和九月返回七月。十月，十一月和十二月返回十月。
    
    结果
    
    本月第一个月对应本月，不为零
  - query
```
public <R> R query(TemporalQuery<R> query)
```
    使用指定的查询查询此月份的一年。
    这使用指定的查询策略对象查询这个月份。 TemporalQuery对象定义了用于获取结果的逻辑。阅读查询的文档，以了解该方法的结果。
    
    该方法的结果是通过调用TemporalQuery.queryFrom(TemporalAccessor)方法获取的指定查询通过this作为参数。
    
    Specified by:
    
    query在界面 TemporalAccessor
    
    参数类型
    
    R - 结果的类型
    
    参数
    
    query - 要调用的查询，不为空
    
    结果
    
    查询结果可能返回null（由查询定义）
    
    异常
    
    DateTimeException - 如果无法查询（由查询定义）
    
    ArithmeticException - 如果发生数字溢出（由查询定义）
  - adjustInto
```
public Temporal adjustInto(Temporal temporal)
```
    将指定的时间对象调整为具有这个月的年份。
    这返回与年月日的输入相同的可观察类型的时间对象与此相同。
    
    调整相当于使用88443774508808通过ChronoField.MONTH_OF_YEAR作为字段。如果指定的时间对象不使用ISO日历系统，则抛出DateTimeException 。
    
    在大多数情况下，通过使用Temporal.with(TemporalAdjuster)来更正呼叫模式：
```
  // these two lines are equivalent, but the second approach is recommended
   temporal = thisMonth.adjustInto(temporal);
   temporal = temporal.with(thisMonth); 
```
    例如，在5月份的日期中，输出以下内容：
```
  dateInMay.with(JANUARY);    // four months earlier
   dateInMay.with(APRIL);      // one months earlier
   dateInMay.with(MAY);        // same date
   dateInMay.with(JUNE);       // one month later
   dateInMay.with(DECEMBER);   // seven months later 
```
    此实例是不可变的，不受此方法调用的影响。
    Specified by:
    
    adjustInto在界面 TemporalAdjuster
    
    参数
    
    temporal - 要调整的目标对象，不为null
    
    结果
    
    调整对象，不为null
    
    异常
    
    DateTimeException - 如果不能进行调整
    
    ArithmeticException - 如果发生数字溢出

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