java.util
クラス Calendar

java.lang.Object
  java.util.Calendar

public abstract class Calendar
extends Object

年、月、日といった要素単位で日付および時刻の情報を取り扱う抽象クラスです。 このクラスの内容は Java 2 Platform, Standard Edition から大幅に縮小されたサブセットです。

取り扱う対象の日時は Date オブジェクトで取り扱います。 この Date クラスはミリ秒単位の精度で日時を保持する専用のクラスです。 より詳しい説明は Date クラスの説明を参照してください。

実際に日時情報を取り扱うクラスは実装によって異なり、その実装の規定する規則に則って Date クラスの情報を解釈します。 このクラスの実装オブジェクトは getInstance() メソッドで取得します。

複数の時間フィールドによって日時情報を取り扱う場合に一部の情報が足りない場合があります。 例えば月と日だけを指定した場合などです。 この場合はデフォルト値が設定されたものとして補われます。 このデフォルト値は実装によって異なります。現在一般に使用されているグレゴリオ暦では、

• YEAR = 1970
• MONTH = JANUARY
• DAY_OF_MONTH = 1

などが補われます（実装が想定するロケールおよび設定されているタイムゾーンによって変化することがあります）。

Java 2 Platform, Standard Edition では一貫性の無い日付指定の問題がありましたが、Java 2 Platfrom, Micro Edition ではこの問題はありません。 CLDC の日付の指定で考えられる組み合わせは、MONTH + DAY_OF_MONTH のみで、DAY_OF_WEEK は日付の指定には使用できません。 なぜなら、DAY_OF_WEEK で日付を設定するには MONTH とその週が月の先頭から何週目であるかを示す WEEK_OF_MONTH が必要ですが、CLDC では省略されているためです。

時刻の設定では一貫性の無い指定が Java 2 Platform, Micro Edition においても可能です。 時刻の設定で考えられる設定は、

• HOUR_OF_DAY
• AM_PM + HOUR

の２種類です。このうち、後から設定された有効な設定を使用します。

０時および１２時の解釈が曖昧になることがありますが、このクラスでは以下の様に解釈します。

• 深夜 0 時（24 時間表現で 0 時あるいは 24 時とされる時間）は午前 0 時と解釈します。
• 午後 12 時は 24 時間表現で 12 時、つまり正午と解釈します。
• 午前 12 時は 24 時間表現で 0 時、つまり深夜 0 時と解釈します。

また以下の指定は無効となり、時刻は変更されません。

• 24 時間表現での指定の場合、24 時 00 分以上の指定は無効です。
• 12 時間表現での指定の場合、12 時を超える時の指定は無効です。

set(int, int) メソッドでありえないようなパラメータを指定（単独・複合に限らず）した際にどのような挙動をするかは実装に依存します。

関連項目:

TimeZone

YEAR

public static final int YEAR

get および set メソッドにおいて年フィールドを示します。

MONTH

public static final int MONTH

get および set メソッドにおいて月フィールドを示します。

DATE

public static final int DATE

get および set メソッドにおいて日フィールドを示します。 これは DAY_OF_MONTH と等価の意味を持ちます。

DAY_OF_MONTH

public static final int DAY_OF_MONTH

get および set メソッドにおいて日フィールドを示します。 これは DATE と等価の意味を持ちます。

DAY_OF_WEEK

public static final int DAY_OF_WEEK

get および set メソッドにおいて曜日フィールドを示します。

AM_PM

public static final int AM_PM

get および set メソッドにおいて午前午後フィールドを示します。

関連項目:

AM, PM, HOUR

HOUR

public static final int HOUR

get および set メソッドにおいて１２時間制での時フィールドを示します。

関連項目:

AM_PM, AM, PM

HOUR_OF_DAY

public static final int HOUR_OF_DAY

get および set メソッドにおいて２４時間制での時フィールドを示します。

MINUTE

public static final int MINUTE

get および set メソッドにおいて分フィールドを示します。

SECOND

public static final int SECOND

get および set メソッドにおいて秒フィールドを示します。

MILLISECOND

public static final int MILLISECOND

get および set メソッドにおいてミリ秒フィールドを示します。

SUNDAY

public static final int SUNDAY

get および set メソッドにおいて DAY_OF_WEEK フィールドに対応する日曜を示します。

MONDAY

public static final int MONDAY

get および set メソッドにおいて DAY_OF_WEEK フィールドに対応する月曜を示します。

TUESDAY

public static final int TUESDAY

get および set メソッドにおいて DAY_OF_WEEK フィールドに対応する火曜を示します。

WEDNESDAY

public static final int WEDNESDAY

get および set メソッドにおいて DAY_OF_WEEK フィールドに対応する水曜を示します。

THURSDAY

public static final int THURSDAY

get および set メソッドにおいて DAY_OF_WEEK フィールドに対応する木曜を示します。

FRIDAY

public static final int FRIDAY

get および set メソッドにおいて DAY_OF_WEEK フィールドに対応する金曜を示します。

SATURDAY

public static final int SATURDAY

get および set メソッドにおいて DAY_OF_WEEK フィールドに対応する土曜を示します。

JANUARY

public static final int JANUARY

get および set メソッドにおいて MONTH フィールドに対応する１番目の月を示します。

FEBRUARY

public static final int FEBRUARY

get および set メソッドにおいて MONTH フィールドに対応する２番目の月を示します。

MARCH

public static final int MARCH

get および set メソッドにおいて MONTH フィールドに対応する３番目の月を示します。

APRIL

public static final int APRIL

get および set メソッドにおいて MONTH フィールドに対応する４番目の月を示します。

MAY

public static final int MAY

get および set メソッドにおいて MONTH フィールドに対応する５番目の月を示します。

JUNE

public static final int JUNE

get および set メソッドにおいて MONTH フィールドに対応する６番目の月を示します。

JULY

public static final int JULY

get および set メソッドにおいて MONTH フィールドに対応する７番目の月を示します。

AUGUST

public static final int AUGUST

get および set メソッドにおいて MONTH フィールドに対応する８番目の月を示します。

SEPTEMBER

public static final int SEPTEMBER

get および set メソッドにおいて MONTH フィールドに対応する９番目の月を示します。

OCTOBER

public static final int OCTOBER

get および set メソッドにおいて MONTH フィールドに対応する１０番目の月を示します。

NOVEMBER

public static final int NOVEMBER

get および set メソッドにおいて MONTH フィールドに対応する１１番目の月を示します。

DECEMBER

public static final int DECEMBER

get および set メソッドにおいて MONTH フィールドに対応する１２番目の月を示します。

AM

public static final int AM

get および set メソッドにおいて AM_PM フィールドに対応する午前を示します。

PM

public static final int PM

get および set メソッドにおいて AM_PM フィールドに対応する午後を示します。

Calendar

protected Calendar()

デフォルトのタイムゾーンおよびロケールによるオブジェクトを構築します。

関連項目:

TimeZone.getDefault()

getTime

public final Date getTime()

保持している日時を返します。

戻り値:

Date 保持している Date オブジェクトのコピーを返します。

setTime

public final void setTime(Date dt)

新たな日時を設定します。 なお、dt に Date(Long.MAX_VALUE) あるいは Date(Long.MIN_VALUE) の設定値が渡された場合、get(int) メソッドによって不正な値を返すことがあります。

パラメータ:

dt - 設定する日時を持った Date オブジェクトを渡します。

getInstance

public static Calendar getInstance()

デフォルトのタイムゾーンおよびロケールの実装オブジェクトを生成します。 実際に返す実装オブジェクトは実装によって異なります。

戻り値:

Calendar クラスの実装オブジェクトを返します。

getInstance

public static Calendar getInstance(TimeZone zone)

渡されたタイムゾーンおよびデフォルトのロケールによる実装オブジェクトを生成します。 実際に返す実装オブジェクトは実装によって異なります。

パラメータ:

zone - 設定するタイムゾーンを渡します。

戻り値:

渡されたタイムゾーンが設定された Calendar クラスの実装オブジェクトを返します。

getTimeInMillis

protected long getTimeInMillis()

設定されている時刻が西暦 1970 年 1 月 1 日 (GMT) から何ミリ秒経過をしているかを返します。

戻り値:

西暦 1970 年 1 月 1 日 (GMT) から何ミリ秒経過しているか返されます。

setTimeInMillis

protected void setTimeInMillis(long ms)

時刻を渡された西暦 1970 年 1 月 1 日 (GMT) からのミリ秒数に対応する時刻に変更します。

パラメータ:

ms - 設定する西暦 1970 年 1 月 1 日 (GMT) からのミリ秒数を渡します。

get

public final int get(int field)

フィールドに対応する時刻の情報を返します。

パラメータ:

field - 取得する対象のフィールドを渡します。

戻り値:

フィールドに対応する時刻の情報を返します。

set

public final void set(int field,
                      int value)

フィールドに対応する時刻の情報を設定します。 ただし、DAY_OF_WEEK フィールドを指定することはできません。

パラメータ:

field - 設定する対象のフィールドを渡します。

value - 設定する対象のフィールドに設定する時刻情報を渡します。

equals

public boolean equals(Object obj)

渡されたオブジェクトがこのオブジェクトと等しいかどうかを返します。 obj が null ではなく、Calendar オブジェクトであり、保持している時刻が同一の場合に true を返します。 その他の場合は false を返します。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - 比較対象のオブジェクトを渡します。

戻り値:

等しい場合は true、等しくない場合は false を返します。

before

public boolean before(Object target)

比較対象の Calendar オブジェクトがこのオブジェクトの時刻よりも以前であるか判定します。

パラメータ:

target - 比較対象の Calendar オブジェクトを渡します。

戻り値:

以前である場合には true を、そうでない場合には false を返します。

after

public boolean after(Object target)

比較対象の Calendar オブジェクトがこのオブジェクトの時刻よりも以後であるか判定します。

パラメータ:

target - 比較対象の Calendar オブジェクトを渡します。

戻り値:

以後である場合には true を、そうでない場合には false を返します。

setTimeZone

public void setTimeZone(TimeZone zone)

新しいタイムゾーンを設定します。 渡されたタイムゾーンを新たなタイムゾーンとして使用します。

パラメータ:

zone - 設定するタイムゾーンを渡します。

getTimeZone

public TimeZone getTimeZone()

現在設定されているタイムゾーンの参照を返します。

戻り値:

現在設定されているタイムゾーンの参照を返します。