java.util
クラス Calendar

java.lang.Object
  java.util.Calendar

public abstract class Calendar
extends Object

Calendar クラスはカレンダー情報の操作を定義する抽象クラスです。

フィールドの概要

static int	AM AM_PM フィールドのデータを指定する際の、午前を表す識別値
static int	AM_PM set(int, int) および get(int) で使用するフィールド値で、HOUR が正午より前か以後かを表します
static int	APRIL MONTH フィールドのデータを指定する際の、4月を表す識別値
static int	AUGUST MONTH フィールドのデータを指定する際の、8月を表す識別値
static int	DATE set(int, int) および get(int) で使用するフィールド値で、月の日を表します。
static int	DAY_OF_MONTH set(int, int) および get(int) で使用するフィールド値で、月の日を表します。
static int	DAY_OF_WEEK set(int, int) および get(int) で使用するフィールド値で、週の日を表します
static int	DECEMBER MONTH フィールドのデータを指定する際の、12月を表す識別値
static int	FEBRUARY MONTH フィールドのデータを指定する際の、2月を表す識別値
static int	FRIDAY DAY_OF_WEEK フィールドのデータを指定する際の、金曜日を表す識別値
static int	HOUR set(int, int) および get(int) で使用するフィールド値で、午前（ AM ）または午後（ PM ）の12時間(0-11)のうちの、時を表します。
static int	HOUR_OF_DAY set(int, int) および get(int) で使用するフィールド値で、24時間(0-23)のうちの、時を表します。
static int	JANUARY MONTH フィールドのデータを指定する際の、1月を表す識別値
static int	JULY MONTH フィールドのデータを指定する際の、7月を表す識別値
static int	JUNE MONTH フィールドのデータを指定する際の、6月を表す識別値
static int	MARCH MONTH フィールドのデータを指定する際の、3月を表す識別値
static int	MAY MONTH フィールドのデータを指定する際の、5月を表す識別値
static int	MILLISECOND set(int, int) および get(int) で使用するフィールド値で、ミリ秒を表します。
static int	MINUTE set(int, int) および get(int) で使用するフィールド値で、分を表します。
static int	MONDAY DAY_OF_WEEK フィールドのデータを指定する際の、月曜日を表す識別値
static int	MONTH set(int, int) および get(int) で使用するフィールド値で、月を表します
static int	NOVEMBER MONTH フィールドのデータを指定する際の、11月を表す識別値
static int	OCTOBER MONTH フィールドのデータを指定する際の、10月を表す識別値
static int	PM AM_PM フィールドのデータを指定する際の、午後を表す識別値
static int	SATURDAY DAY_OF_WEEK フィールドのデータを指定する際の、土曜日を表す識別値
static int	SECOND set(int, int) および get(int) で使用するフィールド値で、秒を表します。
static int	SEPTEMBER MONTH フィールドのデータを指定する際の、9月を表す識別値
static int	SUNDAY DAY_OF_WEEK フィールドのデータを指定する際の、日曜日を表す識別値
static int	THURSDAY DAY_OF_WEEK フィールドのデータを指定する際の、木曜日を表す識別値
static int	TUESDAY DAY_OF_WEEK フィールドのデータを指定する際の、火曜日を表す識別値
static int	WEDNESDAY DAY_OF_WEEK フィールドのデータを指定する際の、水曜日を表す識別値
static int	YEAR set(int, int) および get(int) で使用するフィールド値で、年を表します

メソッドの概要

boolean	after(Object other) この Calendar の時刻が指定された時刻より後であるかどうかを判定します。
boolean	before(Object when) この Calendar の時刻が指定された時刻より前であるかどうかを判定します。
void	clear() この Calendar のすべてのフィールドを未定義にします。
boolean	equals(Object o) 指定されたオブジェクトとこの Calendar が同じタイムゾーンの同じ時刻を表すかどうか判定します。
int	get(int fld) この Calendar オブジェクトの、指定されたフィールドの値を返します。
static Calendar	getInstance() デフォルトのタイムゾーンでの現在の時刻を表す Calendar インスタンスを生成して返します。
static Calendar	getInstance(TimeZone zone) 指定されたタイムゾーンでの現在の時刻を表す Calendar インスタンスを生成して返します。
Date	getTime() この Calendar オブジェクトの時刻を表す Date オブジェクトを返します。
long	getTimeInMillis() この Calendar の時刻を1970 00:00:00からの経過ミリ秒で返します。
TimeZone	getTimeZone() この Calendar のタイムゾーンを返します。
void	set(int fld, int val) この Calendar オブジェクトの、指定されたフィールドを指定された値に設定します。
void	set(int year, int month, int date, int hourOfDay, int minute, int second) この Calendar オブジェクトの、YEAR、MONTH、DATE、HOUR_OF_DAY、MINUTE および SECOND フィールドを設定します。
void	setTime(Date dt) 指定された Date の時刻をこの Calendar に設定します。
void	setTimeInMillis(long ms) 指定された1970 00:00:00からの経過ミリ秒でこの Calendar の時刻を設定します。
void	setTimeZone(TimeZone zone) この Calendar のタイムゾーンを設定します。
String	toString() この Calendar の時刻の文字列表現を返します。

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

getClass, hashCode, notify, notifyAll, wait, wait

フィールドの詳細

YEAR

public static final int YEAR

set(int, int) および get(int) で使用するフィールド値で、年を表します

関連項目:

定数フィールド値

MONTH

public static final int MONTH

set(int, int) および get(int) で使用するフィールド値で、月を表します

関連項目:

定数フィールド値

JANUARY

public static final int JANUARY

MONTH フィールドのデータを指定する際の、1月を表す識別値

関連項目:

定数フィールド値

FEBRUARY

public static final int FEBRUARY

MONTH フィールドのデータを指定する際の、2月を表す識別値

関連項目:

定数フィールド値

MARCH

public static final int MARCH

MONTH フィールドのデータを指定する際の、3月を表す識別値

関連項目:

定数フィールド値

APRIL

public static final int APRIL

MONTH フィールドのデータを指定する際の、4月を表す識別値

関連項目:

定数フィールド値

MAY

public static final int MAY

MONTH フィールドのデータを指定する際の、5月を表す識別値

関連項目:

定数フィールド値

JUNE

public static final int JUNE

MONTH フィールドのデータを指定する際の、6月を表す識別値

関連項目:

定数フィールド値

JULY

public static final int JULY

MONTH フィールドのデータを指定する際の、7月を表す識別値

関連項目:

定数フィールド値

AUGUST

public static final int AUGUST

MONTH フィールドのデータを指定する際の、8月を表す識別値

関連項目:

定数フィールド値

SEPTEMBER

public static final int SEPTEMBER

MONTH フィールドのデータを指定する際の、9月を表す識別値

関連項目:

定数フィールド値

OCTOBER

public static final int OCTOBER

MONTH フィールドのデータを指定する際の、10月を表す識別値

関連項目:

定数フィールド値

NOVEMBER

public static final int NOVEMBER

MONTH フィールドのデータを指定する際の、11月を表す識別値

関連項目:

定数フィールド値

DECEMBER

public static final int DECEMBER

MONTH フィールドのデータを指定する際の、12月を表す識別値

関連項目:

定数フィールド値

AM_PM

public static final int AM_PM

set(int, int) および get(int) で使用するフィールド値で、HOUR が正午より前か以後かを表します

関連項目:

定数フィールド値

AM

public static final int AM

AM_PM フィールドのデータを指定する際の、午前を表す識別値

関連項目:

定数フィールド値

PM

public static final int PM

AM_PM フィールドのデータを指定する際の、午後を表す識別値

関連項目:

定数フィールド値

DATE

public static final int DATE

set(int, int) および get(int) で使用するフィールド値で、月の日を表します。 最初の日には値1が使われます。

関連項目:

定数フィールド値

DAY_OF_MONTH

public static final int DAY_OF_MONTH

set(int, int) および get(int) で使用するフィールド値で、月の日を表します。 最初の日には値1が使われます。

関連項目:

定数フィールド値

DAY_OF_WEEK

public static final int DAY_OF_WEEK

set(int, int) および get(int) で使用するフィールド値で、週の日を表します

関連項目:

定数フィールド値

SUNDAY

public static final int SUNDAY

DAY_OF_WEEK フィールドのデータを指定する際の、日曜日を表す識別値

関連項目:

定数フィールド値

MONDAY

public static final int MONDAY

DAY_OF_WEEK フィールドのデータを指定する際の、月曜日を表す識別値

関連項目:

定数フィールド値

TUESDAY

public static final int TUESDAY

DAY_OF_WEEK フィールドのデータを指定する際の、火曜日を表す識別値

関連項目:

定数フィールド値

WEDNESDAY

public static final int WEDNESDAY

DAY_OF_WEEK フィールドのデータを指定する際の、水曜日を表す識別値

関連項目:

定数フィールド値

THURSDAY

public static final int THURSDAY

DAY_OF_WEEK フィールドのデータを指定する際の、木曜日を表す識別値

関連項目:

定数フィールド値

FRIDAY

public static final int FRIDAY

DAY_OF_WEEK フィールドのデータを指定する際の、金曜日を表す識別値

関連項目:

定数フィールド値

SATURDAY

public static final int SATURDAY

DAY_OF_WEEK フィールドのデータを指定する際の、土曜日を表す識別値

関連項目:

定数フィールド値

HOUR

public static final int HOUR

set(int, int) および get(int) で使用するフィールド値で、午前（ AM ）または午後（ PM ）の12時間(0-11)のうちの、時を表します。 正午は、AM_PM フィールドが PM、HOUR フィールドが0に対応します。 深夜は、AM_PM フィールドが AM、HOUR フィールドが0に対応します。

関連項目:

定数フィールド値

HOUR_OF_DAY

public static final int HOUR_OF_DAY

set(int, int) および get(int) で使用するフィールド値で、24時間(0-23)のうちの、時を表します。

関連項目:

定数フィールド値

MINUTE

public static final int MINUTE

set(int, int) および get(int) で使用するフィールド値で、分を表します。 このフィールドの値域は0から59までです。

関連項目:

定数フィールド値

SECOND

public static final int SECOND

set(int, int) および get(int) で使用するフィールド値で、秒を表します。 このフィールドの値域は0から59までです。

関連項目:

定数フィールド値

MILLISECOND

public static final int MILLISECOND

set(int, int) および get(int) で使用するフィールド値で、ミリ秒を表します。 このフィールドの値域は0から999までです。

関連項目:

定数フィールド値

メソッドの詳細

getInstance

public static Calendar getInstance()

デフォルトのタイムゾーンでの現在の時刻を表す Calendar インスタンスを生成して返します。

戻り値:

現在の時刻を表す Calendar インスタンス

getInstance

public static Calendar getInstance(TimeZone zone)

指定されたタイムゾーンでの現在の時刻を表す Calendar インスタンスを生成して返します。

パラメータ:

zone - タイムゾーン

戻り値:

現在の時刻を表す Calendar インスタンス

get

public final int get(int fld)

この Calendar オブジェクトの、指定されたフィールドの値を返します。

パラメータ:

fld - フィールド識別子。以下のどれかを指定できます。

• AM_PM
• HOUR
• HOUR_OF_DAY
• YEAR
• MONTH
• DAY_OF_MONTH
• MINUTE
• SECOND
• MILLISECOND
• DAY_OF_WEEK

戻り値:

指定されたフィールドの値

例外:

ArrayIndexOutOfBoundsException - fld が有効なフィールド識別子でない場合

set

public final void set(int fld,
                      int val)

この Calendar オブジェクトの、指定されたフィールドを指定された値に設定します。

MINUTE に61を指定する等、明らかに異常な値を指定した場合の振る舞いは保証されません。

パラメータ:

fld - フィールド識別子。以下のどれかを指定できます。

• AM_PM
• HOUR
• HOUR_OF_DAY
• YEAR
• MONTH
• DAY_OF_MONTH
• MINUTE
• SECOND
• MILLISECOND
• DAY_OF_WEEK

val - fldが表すフィールドの値として設定する値

例外:

ArrayIndexOutOfBoundsException - fld が有効なフィールド識別子でない場合

set

public final void set(int year,
                      int month,
                      int date,
                      int hourOfDay,
                      int minute,
                      int second)

この Calendar オブジェクトの、YEAR、MONTH、DATE、HOUR_OF_DAY、MINUTE および SECOND フィールドを設定します。 このメソッドで指定されないフィールド、たとえば MILLISECOND などは変更されません。 この状態が望ましくない場合は、clear() を呼び出してからこのメソッドを呼び出してください。

year に-1を指定する等、明らかに異常な値を指定した場合の振る舞いは保証されません。

パラメータ:

year - YEAR フィールドの値

month - MONTH フィールドの値（ JANUARY - DECEMBER ）

date - DATE フィールドの値(1 - 31)

hourOfDay - HOUR_OF_DAY フィールドの値(0 - 23)

minute - MINUTE フィールドの値(0 - 59)

second - SECOND フィールドの値(0 - 59)

getTime

public final Date getTime()

この Calendar オブジェクトの時刻を表す Date オブジェクトを返します。

戻り値:

この Calendar オブジェクトの時刻を表す Date オブジェクト

setTime

public final void setTime(Date dt)

指定された Date の時刻をこの Calendar に設定します。

パラメータ:

dt - この Calendar に設定する時刻を表す Date オブジェクト

getTimeInMillis

public long getTimeInMillis()

この Calendar の時刻を1970 00:00:00からの経過ミリ秒で返します。

戻り値:

1970 00:00:00からの経過ミリ秒で表したこの Calendar の時刻

toString

public String toString()

この Calendar の時刻の文字列表現を返します。

次の形式の文字列を返します。 [年]/[月]/[日] [時]:[分]:[秒].[ミリ秒]

例： "2011/9/27 19:49:23.121"

オーバーライド:

クラス Object 内の toString

戻り値:

この Calendar の時刻の文字列表現

clear

public final void clear()

この Calendar のすべてのフィールドを未定義にします。

setTimeInMillis

public void setTimeInMillis(long ms)

指定された1970 00:00:00からの経過ミリ秒でこの Calendar の時刻を設定します。

パラメータ:

ms - 1970 00:00:00からの経過ミリ秒

setTimeZone

public void setTimeZone(TimeZone zone)

この Calendar のタイムゾーンを設定します。

パラメータ:

zone - 設定するタイムゾーン

getTimeZone

public TimeZone getTimeZone()

この Calendar のタイムゾーンを返します。

戻り値:

この Calendar のタイムゾーン

before

public boolean before(Object when)

この Calendar の時刻が指定された時刻より前であるかどうかを判定します。

パラメータ:

when - 比較する時刻を表す Calendar オブジェクト

戻り値:

when が Calendar の時刻より後の時刻を表す場合 true、そうでなければ false を返します。 同時刻の場合は false です。 false を返す場合には、when が Calendar またはそのサブクラスのオブジェクトでない場合も含まれます。

after

public boolean after(Object other)

この Calendar の時刻が指定された時刻より後であるかどうかを判定します。

パラメータ:

other - 比較する時刻を表す Calendar オブジェクト

戻り値:

other が Calendar の時刻より前の時刻を表す場合 true、そうでなければ false を返します。 同時刻の場合は false です。 false を返す場合には、other が Calendar またはそのサブクラスのオブジェクトでない場合も含まれます。

equals

public boolean equals(Object o)

指定されたオブジェクトとこの Calendar が同じタイムゾーンの同じ時刻を表すかどうか判定します。

オーバーライド:

クラス Object 内の equals

パラメータ:

o - 比較する Calendar オブジェクト

戻り値:

同じタイムゾーン・時刻を表す場合 true、そうでない場合 false