Class Calendar

package java.util

java.lang.Object
  |
  +--java.util.Calendar

설명

extends Object:

Calendar는 Date 객체 및 YEAR, MONTH, DAY, HOUR 등의 정수 필드 집합 간의 변환을 위한 추상 기본 클래스입니다. (Date 객체는 특정 시간을 밀리초까지 나타냅니다. Date 클래스에 대한 자세한 내용은 Date를 참조하십시오.)

Calendar의 서브 클래스는 특정 달력 시스템의 규칙에 따라 Date를 해석합니다.

로켈에 영향을 받는 다른 클래스와 마찬가지로 Calendar는 일반적으로 유용한 이 유형의 객체를 가져오는 클래스 메소드인 getInstance를 제공합니다.

Calendar 객체는 특정 언어와 달력 스타일 (예: 일본어-그레고리안, 일본어-전통)의 날짜-시간 서식을 구현하는 데 필요한 필드 값을 항상 생성할 수 있습니다.

시간 필드에서 Date를 계산할 때 연도와 달만 있고 일이 없는 경우와 같이 Date를 계산하는 데 필요한 정보가 부족할 수도 있습니다.

정보 부족. 달력은 기본 정보를 사용하여 누락된 필드를 지정합니다. 기본 정보는 달력별로 다를 수 있습니다. 그레고리안력의 경우 필드 기본값은 기원년의 값과 같습니다. 예를 들어, YEAR = 1970년, MONTH = 1월, DATE = 1일과 같습니다.

주: 자정이 어느 날에 속할지에 대한 해석의 모호성은 다음 날에 “속하는” 것으로 해결합니다.

1969년 12월 31일 23:59 < 1970년 1월 1일 00:00

12:00 PM은 정오, 12:00 AM은 자정

1월 1일 11:59 PM < 1월 2일 12:00 AM < 1월 2일 12:01 AM

3월 10일 11:59 AM < 3월 10일 12:00 PM < 3월 10일 12:01 PM

24:00 이상은 유효하지 않습니다. AM/PM 모드에서 12보다 큰 시간은 유효하지 않습니다. 시간 설정은 날짜를 변경하지 않습니다.

같은 시간을 AM/PM 또는 24시간 모드로 입력하면 입력된 시간이 아닌 실제 시간으로 등가를 확인합니다.

이 클래스는 JDK 1.3 Calendar 클래스를 기반으로 하는 J2ME의 하위 집합이었습니다. 이 클래스의 크기를 줄이기 위해 많은 메소드와 변수가 정리되고 다른 메소드가 간소화되었습니다.

See Also:

• Date, TimeZone

필드 요약

• static int AM — 자정부터 정오 직전까지의 시간을 나타내는 AM_PM 필드 값.
• static int AM_PM — HOUR 가 정오 전인지 또는 후인지를 나타내는 get 및 set 의 필드 번호.
• static int APRIL — 한 해의 네 번째 달을 나타내는 MONTH 필드 값.
• static int AUGUST — 한 해의 여덟 번째 달을 나타내는 MONTH 필드 값.
• static int DATE — 날짜를 나타내는 get 및 set 의 필드 번호.
• static int DAY_OF_MONTH — 날짜를 나타내는 get 및 set 의 필드 번호.
• static int DAY_OF_WEEK — 주를 나타내는 get 및 set 의 필드 번호.
• static int DECEMBER — 한 해의 열두 번째 달을 나타내는 MONTH 필드 값.
• static int FEBRUARY — 한 해의 두 번째 달을 나타내는 MONTH 필드 값.
• protected  int[] fields — 이 달력에 현재 설정된 시간의 필드 값.
• static int FRIDAY — 금요일을 나타내는 DAY_OF_WEEK 필드 값.
• static int HOUR — 오전 시간인지 또는 오후 시간인지를 나타내는 get 및 set 의 필드 번호.
• static int HOUR_OF_DAY — 시간을 나타내는 get 및 set 의 필드 번호.
• protected  boolean[] isSet — 달력에 지정된 시간 필드가 설정되었는지 여부를 나타내는 플래그.
• static int JANUARY — 한 해의 첫 번째 달을 나타내는 MONTH 필드 값.
• static int JULY — 한 해의 일곱 번째 달을 나타내는 MONTH 필드 값.
• static int JUNE — 한 해의 여섯 번째 달을 나타내는 MONTH 필드 값.
• static int MARCH — 한 해의 세 번째 달을 나타내는 MONTH 필드 값.
• static int MAY — 한 해의 다섯 번째 달을 나타내는 MONTH 필드 값.
• static int MILLISECOND — 밀리초를 나타내는 get 및 set 의 필드 번호.
• static int MINUTE — 분을 나타내는 get 및 set 의 필드 번호.
• static int MONDAY — 월요일을 나타내는 DAY_OF_WEEK 필드 값.
• static int MONTH — 달을 나타내는 get 및 set 의 필드 번호.
• static int NOVEMBER — 한 해의 열한 번째 달을 나타내는 MONTH 필드 값.
• static int OCTOBER — 한 해의 열 번째 달을 나타내는 MONTH 필드 값.
• static int PM — 정오부터 자정 직전까지의 시간을 나타내는 AM_PM 필드 값.
• static int SATURDAY — 토요일을 나타내는 DAY_OF_WEEK 필드 값.
• static int SECOND — 초를 나타내는 get 및 set 의 필드 번호.
• static int SEPTEMBER — 한 해의 아홉 번째 달을 나타내는 MONTH 필드 값.
• static int SUNDAY — 일요일을 나타내는 DAY_OF_WEEK 필드 값.
• static int THURSDAY — 목요일을 나타내는 DAY_OF_WEEK 필드 값.
• protected  long time — 이 달력에 현재 설정된 시간(1970년 1월 1일, 0:00:00 GMT 이후의 밀리초 단위로 표시)
• static int TUESDAY — 화요일을 나타내는 DAY_OF_WEEK 필드 값.
• static int WEDNESDAY — 수요일을 나타내는 DAY_OF_WEEK 필드 값.
• static int YEAR — 연도를 나타내는 get 및 set 의 필드 번호.

생성자 요약

• protected Calendar () — 기본 표준 시간대를 사용하여 달력을 구성합니다.

메서드 요약

• boolean after ( Object when) — 시간 필드 레코드를 비교합니다.
• boolean before ( Object when) — 시간 필드 레코드를 비교합니다.
• protected abstract  void computeFields () — 현재 밀리초 시간 값인 time 을 fields[] 의 필드 값으로 변환합니다.
• protected abstract  void computeTime () — fields[] 의 현재 필드 값을 밀리초 시간 값인 time 으로 변환합니다.
• boolean equals ( Object obj) — 이 달력을 지정된 객체와 비교합니다.
• int get (int field) — 지정된 시간 필드 값을 가져옵니다.
• static Calendar getInstance () — 기본 표준 시간대를 사용하여 달력을 가져옵니다.
• static Calendar getInstance ( TimeZone zone) — 지정한 표준 시간대를 사용하여 달력을 가져옵니다.
• Date getTime () — 이 달력의 현재 시간을 가져옵니다.
• protected  long getTimeInMillis () — 이 달력의 현재 시간을 가져옵니다(1970년 1월 1일, 0:00:00 GMT(기원년) 이후의 밀리초 단위로 표시된 long).
• TimeZone getTimeZone () — 표준 시간대를 가져옵니다.
• void set (int field, int value) — 지정된 값을 사용하여 시간 필드를 설정합니다.
• void setTime ( Date date) — 지정된 날짜를 사용하여 이 달력의 현재 시간을 설정합니다.
• protected  void setTimeInMillis (long millis) — 지정된 long 값을 사용하여 이 달력의 현재 시간을 설정합니다.
• void setTimeZone ( TimeZone value) — 지정된 표준 시간대 값을 사용하여 표준 시간대를 설정합니다.

필드 상세

YEAR

public static final int YEAR

See Also:

• Constant Field Values

MONTH

public static final int MONTH

See Also:

• Constant Field Values

DATE

public static final int DATE

See Also:

• DAY_OF_MONTH, Constant Field Values

DAY_OF_MONTH

public static final int DAY_OF_MONTH

See Also:

• DATE, Constant Field Values

DAY_OF_WEEK

public static final int DAY_OF_WEEK

See Also:

• Constant Field Values

AM_PM

public static final int AM_PM

See Also:

• AM, PM, HOUR, Constant Field Values

HOUR

public static final int HOUR

See Also:

• AM_PM, HOUR_OF_DAY, Constant Field Values

HOUR_OF_DAY

public static final int HOUR_OF_DAY

See Also:

• Constant Field Values

MINUTE

public static final int MINUTE

See Also:

• Constant Field Values

SECOND

public static final int SECOND

See Also:

• Constant Field Values

MILLISECOND

public static final int MILLISECOND

See Also:

• Constant Field Values

SUNDAY

public static final int SUNDAY

See Also:

• Constant Field Values

MONDAY

public static final int MONDAY

See Also:

• Constant Field Values

TUESDAY

public static final int TUESDAY

See Also:

• Constant Field Values

WEDNESDAY

public static final int WEDNESDAY

See Also:

• Constant Field Values

THURSDAY

public static final int THURSDAY

See Also:

• Constant Field Values

FRIDAY

public static final int FRIDAY

See Also:

• Constant Field Values

SATURDAY

public static final int SATURDAY

See Also:

• Constant Field Values

JANUARY

public static final int JANUARY

See Also:

• Constant Field Values

FEBRUARY

public static final int FEBRUARY

See Also:

• Constant Field Values

MARCH

public static final int MARCH

See Also:

• Constant Field Values

APRIL

public static final int APRIL

See Also:

• Constant Field Values

MAY

public static final int MAY

See Also:

• Constant Field Values

JUNE

public static final int JUNE

See Also:

• Constant Field Values

JULY

public static final int JULY

See Also:

• Constant Field Values

AUGUST

public static final int AUGUST

See Also:

• Constant Field Values

SEPTEMBER

public static final int SEPTEMBER

See Also:

• Constant Field Values

OCTOBER

public static final int OCTOBER

See Also:

• Constant Field Values

NOVEMBER

public static final int NOVEMBER

See Also:

• Constant Field Values

DECEMBER

public static final int DECEMBER

See Also:

• Constant Field Values

AM

public static final int AM

See Also:

• Constant Field Values

PM

public static final int PM

See Also:

• Constant Field Values

fields

protected int[] fields

• 이 달력에 현재 설정된 시간의 필드 값.

isSet

protected boolean[] isSet

• 달력에 지정된 시간 필드가 설정되었는지 여부를 나타내는 플래그. 이는 FIELD_COUNT 부울 배열입니다.

time

protected long time

• 이 달력에 현재 설정된 시간(1970년 1월 1일, 0:00:00 GMT 이후의 밀리초 단위로 표시)

Calendar

protected Calendar()

• 기본 표준 시간대를 사용하여 달력을 구성합니다.

See Also:

• TimeZone.getDefault()

getTime

public final Date getTime()

Returns:

• 현재 시간

See Also:

• setTime(java.util.Date)

setTime

public final void setTime(Date date)

Parameters:

• date - 지정된 날짜

See Also:

• getTime()

getInstance

public static Calendar getInstance()

Returns:

• 달력

getInstance

public static Calendar getInstance(TimeZone zone)

Parameters:

• zone - 사용할 표준 시간대

Returns:

• 달력

getTimeInMillis

protected long getTimeInMillis()

Returns:

• 기원년으로부터의 UTC 밀리초로 표시된 현재 시간

See Also:

• setTimeInMillis(long)

setTimeInMillis

protected void setTimeInMillis(long millis)

Parameters:

• millis - 기원년으로부터의 UTC 밀리초로 표시된 새 시간

See Also:

• getTimeInMillis()

get

public final int get(int field)

Parameters:

• field - 지정된 시간 필드(YEAR, MONTH, DATE, DAY_OF_WEEK, HOUR_OF_DAY, HOUR, AM_PM, MINUTE, SECOND 또는 MILLISECOND)

Returns:

• 지정된 시간 필드 값

Throws:

• ArrayIndexOutOfBoundsException - 매개 변수가 위의 값 중 하나가 아닌 경우

set

public final void set(int field,
                      int value)

Parameters:

• value - 지정된 시간 필드에 설정되는 값

Throws:

• ArrayIndexOutOfBoundsException - 유효하지 않은 필드 매개 변수를 받은 경우

equals

public boolean equals(Object obj)

Overrides:

• equals in class Object

Parameters:

• obj - 비교할 객체

Returns:

• 두 객체가 동일하면 true, 다르면 false

See Also:

• Boolean.hashCode(), Hashtable

before

public boolean before(Object when)

Parameters:

• when - 이 달력과 비교되는 달력

Returns:

• 이 달력의 현재 시간이 when 달력의 시간보다 빠르면 true, 그렇지 않으면 false

after

public boolean after(Object when)

Parameters:

• when - 이 달력과 비교되는 달력

Returns:

• 이 달력의 현재 시간이 when 달력의 시간보다 늦으면 true, 그렇지 않으면 false

setTimeZone

public void setTimeZone(TimeZone value)

Parameters:

• value - 지정된 표준 시간대

See Also:

• getTimeZone()

getTimeZone

public TimeZone getTimeZone()

Returns:

• 이 달력에 연결된 표준 시간대 객체

See Also:

• setTimeZone(java.util.TimeZone)

computeFields

protected abstract void computeFields()

현재 밀리초 시간 값인 time 을 fields[] 의 필드 값으로 변환합니다. 이렇게 하면 시간 필드 값을 달력에 설정된 새 값과 동기화할 수 있습니다.

computeTime

protected abstract void computeTime()

fields[] 의 현재 필드 값을 밀리초 시간 값인 time 으로 변환합니다.

생성자 상세

Calendar

protected Calendar()

• 기본 표준 시간대를 사용하여 달력을 구성합니다.

See Also:

• TimeZone.getDefault()

getTime

public final Date getTime()

Returns:

• 현재 시간

See Also:

• setTime(java.util.Date)

setTime

public final void setTime(Date date)

Parameters:

• date - 지정된 날짜

See Also:

• getTime()

getInstance

public static Calendar getInstance()

Returns:

• 달력

getInstance

public static Calendar getInstance(TimeZone zone)

Parameters:

• zone - 사용할 표준 시간대

Returns:

• 달력

getTimeInMillis

protected long getTimeInMillis()

Returns:

• 기원년으로부터의 UTC 밀리초로 표시된 현재 시간

See Also:

• setTimeInMillis(long)

setTimeInMillis

protected void setTimeInMillis(long millis)

Parameters:

• millis - 기원년으로부터의 UTC 밀리초로 표시된 새 시간

See Also:

• getTimeInMillis()

get

public final int get(int field)

Parameters:

• field - 지정된 시간 필드(YEAR, MONTH, DATE, DAY_OF_WEEK, HOUR_OF_DAY, HOUR, AM_PM, MINUTE, SECOND 또는 MILLISECOND)

Returns:

• 지정된 시간 필드 값

Throws:

• ArrayIndexOutOfBoundsException - 매개 변수가 위의 값 중 하나가 아닌 경우

set

public final void set(int field,
                      int value)

Parameters:

• value - 지정된 시간 필드에 설정되는 값

Throws:

• ArrayIndexOutOfBoundsException - 유효하지 않은 필드 매개 변수를 받은 경우

equals

public boolean equals(Object obj)

Overrides:

• equals in class Object

Parameters:

• obj - 비교할 객체

Returns:

• 두 객체가 동일하면 true, 다르면 false

See Also:

• Boolean.hashCode(), Hashtable

before

public boolean before(Object when)

Parameters:

• when - 이 달력과 비교되는 달력

Returns:

• 이 달력의 현재 시간이 when 달력의 시간보다 빠르면 true, 그렇지 않으면 false

after

public boolean after(Object when)

Parameters:

• when - 이 달력과 비교되는 달력

Returns:

• 이 달력의 현재 시간이 when 달력의 시간보다 늦으면 true, 그렇지 않으면 false

setTimeZone

public void setTimeZone(TimeZone value)

Parameters:

• value - 지정된 표준 시간대

See Also:

• getTimeZone()

getTimeZone

public TimeZone getTimeZone()

Returns:

• 이 달력에 연결된 표준 시간대 객체

See Also:

• setTimeZone(java.util.TimeZone)

computeFields

protected abstract void computeFields()

현재 밀리초 시간 값인 time 을 fields[] 의 필드 값으로 변환합니다. 이렇게 하면 시간 필드 값을 달력에 설정된 새 값과 동기화할 수 있습니다.

computeTime

protected abstract void computeTime()

fields[] 의 현재 필드 값을 밀리초 시간 값인 time 으로 변환합니다.

메서드 상세

getTime

public final Date getTime()

Returns:

• 현재 시간

See Also:

• setTime(java.util.Date)

setTime

public final void setTime(Date date)

Parameters:

• date - 지정된 날짜

See Also:

• getTime()

getInstance

public static Calendar getInstance()

Returns:

• 달력

getInstance

public static Calendar getInstance(TimeZone zone)

Parameters:

• zone - 사용할 표준 시간대

Returns:

• 달력

getTimeInMillis

protected long getTimeInMillis()

Returns:

• 기원년으로부터의 UTC 밀리초로 표시된 현재 시간

See Also:

• setTimeInMillis(long)

setTimeInMillis

protected void setTimeInMillis(long millis)

Parameters:

• millis - 기원년으로부터의 UTC 밀리초로 표시된 새 시간

See Also:

• getTimeInMillis()

get

public final int get(int field)

Parameters:

• field - 지정된 시간 필드(YEAR, MONTH, DATE, DAY_OF_WEEK, HOUR_OF_DAY, HOUR, AM_PM, MINUTE, SECOND 또는 MILLISECOND)

Returns:

• 지정된 시간 필드 값

Throws:

• ArrayIndexOutOfBoundsException - 매개 변수가 위의 값 중 하나가 아닌 경우

set

public final void set(int field,
                      int value)

Parameters:

• value - 지정된 시간 필드에 설정되는 값

Throws:

• ArrayIndexOutOfBoundsException - 유효하지 않은 필드 매개 변수를 받은 경우

equals

public boolean equals(Object obj)

Overrides:

• equals in class Object

Parameters:

• obj - 비교할 객체

Returns:

• 두 객체가 동일하면 true, 다르면 false

See Also:

• Boolean.hashCode(), Hashtable

before

public boolean before(Object when)

Parameters:

• when - 이 달력과 비교되는 달력

Returns:

• 이 달력의 현재 시간이 when 달력의 시간보다 빠르면 true, 그렇지 않으면 false

after

public boolean after(Object when)

Parameters:

• when - 이 달력과 비교되는 달력

Returns:

• 이 달력의 현재 시간이 when 달력의 시간보다 늦으면 true, 그렇지 않으면 false

setTimeZone

public void setTimeZone(TimeZone value)

Parameters:

• value - 지정된 표준 시간대

See Also:

• getTimeZone()

getTimeZone

public TimeZone getTimeZone()

Returns:

• 이 달력에 연결된 표준 시간대 객체

See Also:

• setTimeZone(java.util.TimeZone)

computeFields

protected abstract void computeFields()

현재 밀리초 시간 값인 time 을 fields[] 의 필드 값으로 변환합니다. 이렇게 하면 시간 필드 값을 달력에 설정된 새 값과 동기화할 수 있습니다.

computeTime

protected abstract void computeTime()

fields[] 의 현재 필드 값을 밀리초 시간 값인 time 으로 변환합니다.