Month (Java Platform SE 8)

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

すべての実装されたインタフェース:

Serializable, Comparable<Month>, TemporalAccessor, TemporalAdjuster
```
public enum Month
extends Enum<Month>
implements TemporalAccessor, TemporalAdjuster
```
「月」(「July」など)。
Monthは、1年の12か月(1月、2月、3月、4月、5月、6月、7月、8月、9月、10月、11月、12月)を表す列挙型です。
各月には、テキストの列挙名の他にint値もあります。このint値は、通常の使用法およびISO-8601標準に準拠して、1(1月)-12(12月)になります。コードをわかりやすくするために、アプリケーションはint値ではなく列挙型を使用することをお薦めします。
Monthの数値表現の取得にordinal()を使用しないでください。かわりにgetValue()を使用してください。
この列挙型は、多くの暦体系に見られる共通の概念を表現します。そのためこの列挙型は、ISO-8601の暦体系とまったく同等であると定義された月の概念を持つどの暦体系でも使用できます。

実装要件:

これは不変でスレッドセーフな列挙型です。

導入されたバージョン:

1.8

列挙型定数のサマリー

列挙型定数
列挙型定数と説明
`APRIL` 30日まである4月を表すシングルトン・インスタンスです。
`AUGUST` 31日まである8月を表すシングルトン・インスタンスです。
`DECEMBER` 31日まである12月を表すシングルトン・インスタンスです。
`FEBRUARY` 28日または29日(うるう年)まである2月を表すシングルトン・インスタンスです。
`JANUARY` 31日まである1月を表すシングルトン・インスタンスです。
`JULY` 31日まである7月を表すシングルトン・インスタンスです。
`JUNE` 30日まである6月を表すシングルトン・インスタンスです。
`MARCH` 31日まである3月を表すシングルトン・インスタンスです。
`MAY` 31日まである5月を表すシングルトン・インスタンスです。
`NOVEMBER` 30日まである11月を表すシングルトン・インスタンスです。
`OCTOBER` 31日まである10月を表すシングルトン・インスタンスです。
`SEPTEMBER` 30日まである9月を表すシングルトン・インスタンスです。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`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()` この列挙型の定数を含む配列を、宣言されている順序で返します。

クラス java.lang.Enumから継承されたメソッド
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

クラス java.lang.Objectから継承されたメソッド
getClass, notify, notifyAll, wait, wait, wait

- 列挙型定数の詳細
  - JANUARY
```
public static final Month JANUARY
```
    31日まである1月を表すシングルトン・インスタンスです。これの数値は1です。
  - FEBRUARY
```
public static final Month FEBRUARY
```
    28日または29日(うるう年)まである2月を表すシングルトン・インスタンスです。これの数値は2です。
  - MARCH
```
public static final Month MARCH
```
    31日まである3月を表すシングルトン・インスタンスです。これの数値は3です。
  - APRIL
```
public static final Month APRIL
```
    30日まである4月を表すシングルトン・インスタンスです。これの数値は4です。
  - MAY
```
public static final Month MAY
```
    31日まである5月を表すシングルトン・インスタンスです。これの数値は5です。
  - JUNE
```
public static final Month JUNE
```
    30日まである6月を表すシングルトン・インスタンスです。これの数値は6です。
  - JULY
```
public static final Month JULY
```
    31日まである7月を表すシングルトン・インスタンスです。これの数値は7です。
  - AUGUST
```
public static final Month AUGUST
```
    31日まである8月を表すシングルトン・インスタンスです。これには、数値の8が入ります。
  - SEPTEMBER
```
public static final Month SEPTEMBER
```
    30日まである9月を表すシングルトン・インスタンスです。これには、数値の9が入ります。
  - OCTOBER
```
public static final Month OCTOBER
```
    31日まである10月を表すシングルトン・インスタンスです。これには、数値の10が入ります。
  - NOVEMBER
```
public static final Month NOVEMBER
```
    30日まである11月を表すシングルトン・インスタンスです。これには、数値の11が入ります。
  - DECEMBER
```
public static final Month DECEMBER
```
    31日まである12月を表すシングルトン・インスタンスです。これには、数値の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 - 引数がnullの場合
  - of
```
public static Month of(int month)
```
    int値からMonthのインスタンスを取得します。
    Monthは1年の12か月を表す列挙型です。このファクトリを使用すると、int値から列挙型を取得できます。このint値は、ISO-8601標準に準拠して、1(1月)-12(12月)になります。
    
    パラメータ:
    
    month - 表される月。1(1月)-12(12月)
    
    戻り値:
    
    月。null以外
    
    例外:
    
    DateTimeException - その月が無効である場合
  - from
```
public static Month from(TemporalAccessor temporal)
```
    時間的オブジェクトからMonthのインスタンスを取得します。
    これは、指定された時間的オブジェクトに基づいて月を取得します。TemporalAccessorは任意の日付と時間のセットに関する情報を表し、それがこのファクトリでMonthのインスタンスに変換されます。
    この変換では、MONTH_OF_YEARフィールドを抽出します。この抽出が許可されるのは、時間的オブジェクトにISOの暦が含まれているか、そのオブジェクトをLocalDateに変換できる場合にかぎられます。
    このメソッドは、関数型インタフェースTemporalQueryのシグネチャに一致するため、メソッド参照Month::fromを介して問合せで使用できます。
    
    パラメータ:
    
    temporal - 変換する一時オブジェクト、null以外
    
    戻り値:
    
    月。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月」などのテキスト表現を取得します。
    これは、ユーザへの表示に適した、月の識別に使用されるテキスト名を返します。パラメータは返されるテキストとロケールのスタイルを制御します。
    テキスト・マッピングが見つからない場合、数値が返されます。
    
    パラメータ:
    
    style - 必要なテキストの長さ、nullでない
    
    locale - 使用するロケール。null以外
    
    戻り値:
    
    月のテキスト値。null以外
  - isSupported
```
public boolean isSupported(TemporalField field)
```
    指定されたフィールドがサポートされているかどうかをチェックします。
    これは、指定されたフィールドをこの月に問い合せることができるかどうかを確認します。falseの場合、rangeメソッドとgetメソッドを呼び出すと例外がスローされます。
    フィールドがMONTH_OF_YEARである場合、このメソッドはtrueを返します。他のすべてのChronoFieldインスタンスはfalseを返します。
    フィールドがChronoFieldでない場合、このメソッドの結果は、thisを引数として渡してTemporalField.isSupportedBy(TemporalAccessor)を呼び出すことによって取得します。フィールドがサポートされているかどうかはフィールドによって決定します。
    
    定義:
    
    インタフェースTemporalAccessorのisSupported
    
    パラメータ:
    
    field - チェックするフィールド、nullはfalseを返す
    
    戻り値:
    
    フィールドがこの月でサポートされている場合はtrue、サポートされていない場合はfalse
  - range
```
public ValueRange range(TemporalField field)
```
    指定されたフィールドの有効な値の範囲を取得します。
    範囲オブジェクトはフィールドの有効な最小値と最大値を表します。この月は、返される範囲の精度を高めるために使用されます。範囲を返せない場合は、フィールドがサポートされていないか他のなんらかの理由で、例外がスローされます。
    フィールドがMONTH_OF_YEARである場合は、月の範囲(1-12)が返されます。他のすべてのChronoFieldインスタンスはUnsupportedTemporalTypeExceptionをスローします。
    フィールドがChronoFieldではない場合、このメソッドの結果は、引数としてthisを渡してTemporalField.rangeRefinedBy(TemporalAccessor)を呼び出すことにより取得されます。範囲を取得できるかどうかはフィールドによって決まります。
    
    定義:
    
    インタフェースTemporalAccessorのrange
    
    パラメータ:
    
    field - 範囲を問い合わせるフィールド、null以外
    
    戻り値:
    
    フィールドの有効値の範囲。null以外
    
    例外:
    
    DateTimeException - フィールドの範囲を取得できない場合
    
    UnsupportedTemporalTypeException - フィールドがサポートされていない場合
  - get
```
public int get(TemporalField field)
```
    指定されたフィールドの値をこの月からintとして取得します。
    これは、指定されたフィールドの値をこの月に問い合わせます。返される値は常にフィールドの値の有効な範囲内になります。値を返せない場合は、フィールドがサポートされていないか他のなんらかの理由で、例外がスローされます。
    フィールドがMONTH_OF_YEARである場合は、月の値(1-12)が返されます。他のすべてのChronoFieldインスタンスはUnsupportedTemporalTypeExceptionをスローします。
    フィールドがChronoFieldではない場合、このメソッドの結果は、引数としてthisを渡してTemporalField.getFrom(TemporalAccessor)を呼び出すことにより取得されます。値を取得できるかどうか、および値が何を表すかは、フィールドによって決まります。
    
    定義:
    
    インタフェースTemporalAccessorのget
    
    パラメータ:
    
    field - 取得するフィールド、null以外
    
    戻り値:
    
    フィールドの値、値の有効な範囲内
    
    例外:
    
    DateTimeException - フィールドの値を取得できない場合、または値がフィールドの有効な値の範囲外の場合
    
    UnsupportedTemporalTypeException - フィールドがサポートされていない場合、または値の範囲がintを超えている場合
    
    ArithmeticException - 数値のオーバーフローが発生した場合
  - getLong
```
public long getLong(TemporalField field)
```
    指定されたフィールドの値をこの月からlongとして取得します。
    これは、指定されたフィールドの値をこの月に問い合わせます。値を返せない場合は、フィールドがサポートされていないか他のなんらかの理由で、例外がスローされます。
    フィールドがMONTH_OF_YEARである場合は、月の値(1-12)が返されます。他のすべてのChronoFieldインスタンスはUnsupportedTemporalTypeExceptionをスローします。
    フィールドがChronoFieldではない場合、このメソッドの結果は、引数としてthisを渡してTemporalField.getFrom(TemporalAccessor)を呼び出すことにより取得されます。値を取得できるかどうか、および値が何を表すかは、フィールドによって決まります。
    
    定義:
    
    インタフェースTemporalAccessorのgetLong
    
    パラメータ:
    
    field - 取得するフィールド、null以外
    
    戻り値:
    
    フィールドの値
    
    例外:
    
    DateTimeException - フィールドの値を取得できない場合
    
    UnsupportedTemporalTypeException - フィールドがサポートされていない場合
    
    ArithmeticException - 数値のオーバーフローが発生した場合
  - plus
```
public Month plus(long months)
```
    この月から指定された数の四半期が経過した後の月を返します。
    この計算は、年の終わりで12月から1月に戻ります。指定する期間は負でもかまいません。
    このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
    
    パラメータ:
    
    months - 加算する月数(正または負)
    
    戻り値:
    
    結果となる月。null以外
  - minus
```
public Month minus(long months)
```
    この月から指定された月数だけ遡った月を返します。
    この計算は、年の始めで1月から12月に戻ります。指定する期間は負でもかまいません。
    このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
    
    パラメータ:
    
    months - 減算する月数(正または負)
    
    戻り値:
    
    結果となる月。null以外
  - length
```
public int length(boolean leapYear)
```
    この月の長さ(日数)を取得します。
    これは、うるう年の長さを返すかどうかを判断するためのフラグを取ります。
    2月は、標準の年では28日まであり、うるう年では29日まであります。4月、6月、9月、および11月は30日まであります。他のすべての月は31日まであります。
    
    パラメータ:
    
    leapYear - うるう年の長さが必要な場合はtrue
    
    戻り値:
    
    この月の長さ(日数)。28-31
  - minLength
```
public int minLength()
```
    この月の最小の長さ(日数)を取得します。
    2月の最小の長さは28日です。4月、6月、9月、および11月は30日まであります。他のすべての月は31日まであります。
    
    戻り値:
    
    この月の最小の長さ(日数)。28-31
  - maxLength
```
public int maxLength()
```
    この月の最大の長さ(日数)を取得します。
    2月の最大の長さは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年は4つの四半期に分けることができます。このメソッドは、ベース月の四半期の最初の月を返します。1月、2月、および3月は、1月を返します。4月、5月、および6月は、4月を返します。7月、8月、および9月は、7月を返します。10月、11月、および12月は、10月を返します。
    
    戻り値:
    
    この月に対応する四半期の最初の月。null以外
  - query
```
public <R> R query(TemporalQuery<R> query)
```
    指定された問合せを使用してこの月を問い合わせます。
    これは、指定された問合せ方針オブジェクトを使用してこの月を問い合わせます。TemporalQueryオブジェクトは結果を取得するために使用するロジックを定義します。このメソッドの結果を理解するには、問合せのドキュメントをお読みください。
    このメソッドの結果は、thisを引数として渡して、指定した問合せでTemporalQuery.queryFrom(TemporalAccessor)メソッドを呼び出すことによって取得します。
    
    定義:
    
    インタフェースTemporalAccessorのquery
    
    型パラメータ:
    
    R - 結果の型
    
    パラメータ:
    
    query - 呼び出す問合せ、null以外
    
    戻り値:
    
    問合せ結果、nullが返されることがある(問合せによって定義される)
    
    例外:
    
    DateTimeException - 問い合わせできない場合(問合せによって定義される)
    
    ArithmeticException - 数値のオーバーフローが発生した場合(問合せによって定義される)
  - adjustInto
```
public Temporal adjustInto(Temporal temporal)
```
    指定された時間的オブジェクトを、この月が含まれるように調整します。
    これは、月をこれと同じになるように変更して、入力と同じ識別可能な型の時間的オブジェクトを返します。
    この調整は、ChronoField.MONTH_OF_YEARをフィールドとして渡してTemporal.with(TemporalField, long)を使用することと同等です。指定された時間的オブジェクトが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
 
```
    このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
    定義:
    
    インタフェースTemporalAdjusterのadjustInto
    
    パラメータ:
    
    temporal - 調整するターゲット・オブジェクト、null以外
    
    戻り値:
    
    調整されるオブジェクト、null以外
    
    例外:
    
    DateTimeException - 調整を実行できない場合
    
    ArithmeticException - 数値のオーバーフローが発生した場合

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

列挙型Month

列挙型定数のサマリー

メソッドのサマリー

クラス java.lang.Enumから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

列挙型定数の詳細

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