|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object | +--java.util.Calendar
Calendar 는 Date 오브젝트와YEAR,MONTH,DAY,HOUR 등의 정수 필드의 사이에 변환을 행하기 위한 추상 base class입니다. Date 오브젝트는 특정의 시점을 나타내, 밀리 세컨드의 정밀도를 가지고 있습니다. Date 클래스에 대해서는 Date 를 참조해 주세요.
Calendar 의 서브 클래스는 특정의 달력 시스템의 규칙에 따라 Date 를 해석합니다. 플랫폼에서는 Calendar 의 구상 서브 클래스로서 GregorianCalendar 가 제공됩니다. 장래의 서브 클래스에서는 세계의 여러가지 장소에서 사용되는 다종의 달력(일력)을 나타낼 수 있게 되겠지요.
로케일에 의존하는 다른 클래스와 같이,Calendar 에서는 이런 종류의 일반적으로 도움이 되는 오브젝트를 얻기 위한 클래스 메소드 getInstance 가 제공됩니다. Calendar 의 getInstance 메소드는 Calendar 오브젝트를 돌려줍니다만, 이 시간 필드는 현재의 일자와 시각에 초기화되고 있습니다.
Calendar rightNow = Calendar.getInstance();
Calendar 오브젝트에서는 특정의 언어 및 달력 스타일 (일본의 태양력, 일본의 음력등)에 대해서, 일자와 시각의 포맷을 실시할 때 필요한 모든 시간 필드치를 생성할 수 있습니다. Calendar 에서는 특정의 필드와 그 의미의 양쪽 모두에 의해 돌려주어지는 값의 범위가 정의됩니다. 예를 들어, 연도의 최초의 달에는 모든 달력에 대해 값 MONTH == JANUARY 가 있습니다. 다른 값은 ERA 및 YEAR 등의 구상 서브 클래스에서 정의됩니다. 자세한 것은 개별의 필드 문서 및 서브 클래스 문서를 참조해 주세요.
Calendar 가 lenient 의 경우는 작성되는 것보다도 넓은 범위의 필드치가 받아들입니다. 예를 들어, 엄밀하지 않는 GregorianCalendar 에서는 MONTH == JANUARY,DAY_OF_MONTH == 32 가 2 월 1 일로서 해석됩니다. 엄밀한 GregorianCalendar 에서는 범위외의 필드 설정이 지정되면(자) 예외가 슬로우 됩니다. get() 의 반환값에 의해, 달력으로 필드치가 재계산되면(자), 그 필드치가 정규화됩니다. 예를 들어,GregorianCalendar 에서는 1 으로부터 달의 길이까지의 DAY_OF_MONTH 치가 항상 작성됩니다.
Calendar 에서는 주의 최초의 날 및 최초의 주의 최소 날짜 (1 에서 7)라고 하는 2 개의 파라미터를 사용해, 로케일 고유의 주 7 일이 정의됩니다. 이러한 수는 Calendar 가 구축될 때 로케일 resource data로부터 취득됩니다. 또, API 에 의해 명시적으로 지정되는 일도 있습니다.
WEEK_OF_MONTH 필드나 WEEK_OF_YEAR 필드를 설정 또는 취득하면(자),Calendar 에서는 달 또는 해의 최초의 주를 참조점으로서 결정할 필요가 있습니다. 달 또는 해의 최초의 주는 getFirstDayOfWeek() 로 시작되어, 그 달 또는 해의 적어도 getMinimalDaysInFirstWeek() 의 날짜를 포함한, 가장 빠른 7 일간으로서 정의됩니다....,-1, 0 이라고 하는 번호를 붙일 수 있었던 주는 최초의 주보다 전에 있습니다. 2, 3,... 그렇다고 하는 번호를 붙일 수 있었던 주는 최초의 주부터 뒤에 있습니다. get() 에 의해 돌려주어지는 정규화된 번호부란, 다른 경우가 있습니다. 예를 들어, 특정의 Calendar 서브 클래스에서는 1 년의 주 1 의 전의 주를, 전년의 주 n 로서 지정하는 일이 있습니다.
복수의 시간 필드로부터 Date 를 계산하는 경우, 2 kr의 특별한 상황이 되는 일이 있습니다. 즉,Date 를 계산하기 위한 정보가 부족하다 (해와 달에만 날이 없다), 또는 정보에 일관성이 없는 (예를 들어 「Tuesday, July 15, 1996」으로, July 15, 1996 은 실제로는 Monday) 경우입니다.
정보가 불충분하다 - 이 달력에서는 디폴트 정보를 사용해 부족한 정보를 보충합니다. 이것은 달력에 따라서 다릅니다. 태양력의 경우, 필드의 디폴트 값은 그 기간의 처음의 값입니다. 즉, YEAR = 1970, MONTH = JANUARY, DATE = 1 등입니다.
정보에 일관성이 없는 - 필드가 모순되고 있는 경우, 달력은 나중에 설정된 필드를 우선합니다. 예를 들어, 일자를 판정할 경우에는 달력은 다음의 필드의 편성의 어떤 것인지를 찾습니다. 무엇보다 최근으로 설정된 필드에 의해 판정되는 최신의 편성이 사용됩니다.
시각의 경우MONTH + DAY_OF_MONTH MONTH + WEEK_OF_MONTH + DAY_OF_WEEK MONTH + DAY_OF_WEEK_IN_MONTH + DAY_OF_WEEK DAY_OF_YEAR DAY_OF_WEEK + WEEK_OF_YEAR
HOUR_OF_DAY AM_PM + HOUR
주: 일부의 비태양력으로는 애매함을 완전하게 없애기 위해서(때문에), 다른 필드가 필요하게 되는 경우가 있습니다. 예를 들어, 아라비아의 옛 천문달력(일력)에 나타내려면 , 년, 월, 월의 날, 및 경우에 따라서는 요일이 필요합니다.
주: 일부의 특별한 시간으로는 그 해석이 애매하게 될 수도 있습니다. 그 경우에는 다음과 같이 해결됩니다.
일자나 시각의 포맷 캐릭터 라인은 달력의 정의의 일부에서는 없습니다. 이것들이 실행시에 유저에 의해 수정 가능해, 오버라이드(override) 가능한 필요가 있기 (위해)때문에입니다. 일자를 포맷 하려면 ,DateFormat 를 사용해 주세요.
필드 조작 메소드
Calendar 필드는 set(),add(), 및 roll() 라고 하는 3 개의 메소드를 사용해 변경할 수 있습니다.
set(f, value) 에서는 필드 f 가 value 로 변경됩니다. 게다가 필드 f 가 변경된 것을 나타내도록(듯이) 내부 멤버 변수가 설정됩니다. f 는 즉시 변경됩니다만, 달력의 밀리 세컨드는 get(),getTime(), 또는 getTimeInMillis() 가 다음에 불려 갈 때까지 재계산되지 않습니다. 이와 같이,set() 를 여러 차례 호출해도, 복수의 불필요한 계산을 할 것은 없습니다. set() 를 사용해 필드를 변경하면(자), 필드, 필드치, 및 달력 시스템에 의해 다른 필드도 변경되는 일이 있습니다. 게다가get(f) 에서는 필드가 재계산된 뒤에 반드시 value 가 돌려주어진다고는 할 수 없습니다. 이러한 자세한 것은 구상 달력 클래스에 의해 결정됩니다.
예: 최초로 1999 년 8 월 31 일로 설정된 GregorianCalendar 를 생각합니다. set(Calendar.MONTH, Calendar.SEPTEMBER) 를 호출하면(자), 달력이 1999 년 9 월 31 일로 설정됩니다. 이것은 일시적인 내부 표현이며,getTime() 를 호출하면(자) 1999 년 10 월 1 일이 됩니다. 다만,getTime() 를 호출하기 전에 set(Calendar.DAY_OF_MONTH, 30) 를 호출하면(자),set() 자체의 후에 재계산을 하기 위해서(때문에), 달력이 1999 년 9 월 30 일로 설정됩니다.
add(f, delta) 에서는 필드 f 에 delta 가 추가됩니다. 이것은 2 개의 조정에 의해 set(f, get(f) + delta) 를 호출하는 것과 같습니다.
Add rule 1. 호출이 필드
f로 발생한 모듈로 오버플로우delta가 되기 전에, 호출로 필드f의 값을 깎은 뒤의f의 값입니다. 오버플로우는 필드의 값이 범위를 넘어, 그 결과다음의 큰 필드가 증분 또는 감 분 되어 필드의 값이 그 범위에 들어가도록(듯이) 조정되었을 경우에 발생합니다.Add rule 2. 작은 필드가 불변식이다고 예상되는 경우에, 필드
f가 변경되고 나서 최소치 또는 최대치가 변경되었기 때문에, 그 전의 값과 동일하게 안 되면 필드의 값은 그 예상되는 값으로 할 수 있을 뿐(만큼) 가까운 시일내에 되도록(듯이) 조정됩니다. 작은 필드는 작은 시간의 단위를 나타냅니다.HOUR는DAY_OF_MONTH보다 작은 필드입니다. 불변식은 아니라고 예상되는 작은 필드는 조정되지 않습니다. 달력 시스템에서는 불변식이다고 예상되는 필드가 판단됩니다.
게다가set() 과는 달리,add() 에서는 달력의 밀리 세컨드 및 모든 필드가 즉시 강제적으로 재계산됩니다.
예: 최초로 1999 년 8 월 31 일로 설정된 GregorianCalendar 를 생각합니다. add(Calendar.MONTH, 13) 를 호출하면(자), 달력이 2000 년 9 월 30 일로 설정됩니다. 8 월에 13 개월을 추가하면(자) 다음 해의 9 월이 되기 (위해)때문에,Add rule 1 에 의해 MONTH 필드가 9 월로 설정됩니다. DAY_OF_MONTH 은 GregorianCalendar 에서는 9 월의 31 일에는 할 수 없기 때문에,add rule 2 에 의해 DAY_OF_MONTH 가 가장 가까운 가능한 값의 30 으로 설정됩니다. 이것은 작은 필드입니다만,GregorianCalendar 로 달이 변경될 때 변경이 예정되어 있기 (위해)때문에,DAY_OF_WEEK 는 룰 2 에 따라서는 조정되지 않습니다.
roll(f, delta) 에서는 큰 필드를 변경하지 않고 필드 f 에 delta 가 추가됩니다. 이것은 이하의 조정에 의해 add(f, delta) 를 호출하는 것과 같습니다.
Roll rule. 호출뒤, 큰 필드는 변경되지 않습니다. 큰 필드는 큰 시간의 단위를 나타냅니다.
DAY_OF_MONTH는HOUR보다 큰 필드입니다.
예: GregorianCalendar.roll(int, int) 를 참조해 주세요.
사용법모델. add() 및 roll() 의 동작을 동기마련 하기 위해서, 월, 일, 년, 및 기본이 되는 GregorianCalendar 의 증분 버튼과 감 분버튼이 있는 유저 인터페이스 컴퍼넌트를 생각합니다. 인터페이스로 1999 년 1 월 31 일이 읽혀 유저가 달증분 버튼을 누르면(자), 무엇이 읽힐까요. 기본이 되는 구현으로 set() 가 사용되는 경우는 1999 년 3 월 3 일이 읽힙니다. 1999 년 2 월 28 일이 되는 편이 좋습니다만, 게다가 유저가 달증분 버튼을 다시 눌렀을 경우는 1999 년 3 월 28 일은 아니고 1999 년 3 월 31 일이 읽힐 필요가 있습니다. 원의 일자를 보존해, 큰 필드가 영향을 받을지 어떨지에 의해 add() 또는 roll() 를 사용하는 것으로, 유저 인터페이스가 대부분의 유저가 직관적으로 기대하는 대로 동작합니다.
Date ,
GregorianCalendar ,
TimeZone ,
DateFormat ,
직렬화 된 형식 | 필드의 개요 | |
static int |
AM
한밤 중부터 정오의 전까지의 시간을 나타내는 AM_PM 필드의 값입니다. |
static int |
AM_PM
get 및 set 를 위한 필드치로,HOUR 가 정오보다 전일까 다음에 있는지를 나타냅니다. |
static int |
APRIL
4 번째의 달을 나타내는 MONTH 필드의 값입니다. |
protected boolean |
areFieldsSet
fields[] 가 현재 설정되어 있을 때 각과 동기를 잡고 있는 경우는 true 입니다. |
static int |
AUGUST
8 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
DATE
get 및 set 를 위한 필드치로, 달의 날을 나타냅니다. |
static int |
DAY_OF_MONTH
get 및 set 를 위한 필드치로, 달의 날을 나타냅니다. |
static int |
DAY_OF_WEEK
get 및 set 를 위한 필드치로, 요일을 나타냅니다. |
static int |
DAY_OF_WEEK_IN_MONTH
get 및 set 를 위한 필드치로, 현재의 달의 몇번눈의 요일인지를 나타냅니다. |
static int |
DAY_OF_YEAR
get 및 set 를 위한 필드치로, 현재의 해의 며칠눈인지를 나타냅니다. |
static int |
DECEMBER
12 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
DST_OFFSET
get 및 set 를 위한 필드치로, 서머타임의 오프셋(offset)를 밀리 세컨드 단위로 가리킵니다.
|
static int |
ERA
get 및 set 를 위한 필드치로, 율리우스력의 AD 또는 BC 등의 연대를 나타냅니다. |
static int |
FEBRUARY
2 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
FIELD_COUNT
get 및 set 에 의해 식별되는 중복 하지 않는 필드의 수를 나타냅니다. |
protected int[] |
fields
이 달력으로 현재 설정되어 있을 때 각에 대한 필드치입니다. |
static int |
FRIDAY
금요일을 나타내는 DAY_OF_WEEK 필드의 값입니다. |
static int |
HOUR
get 및 set 를 위한 필드치로, 오전 또는 오후의 몇시인지를 나타냅니다. |
static int |
HOUR_OF_DAY
get 및 set 를 위한 필드치로, 시각을 나타냅니다. |
protected boolean[] |
isSet
지정된 시간 필드가 달력으로 설정되어 있는지 어떤지를 나타내는 플래그입니다. |
protected boolean |
isTimeSet
time 의 값이 유효한 경우는 true 입니다. |
static int |
JANUARY
해의 최초의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
JULY
7 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
JUNE
6 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
MARCH
3 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
MAY
5 번째의 달을 나타내는 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
11 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
OCTOBER
10 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
PM
정오부터 한밤 중의 전까지의 시간을 나타내는 AM_PM 필드의 값입니다. |
static int |
SATURDAY
토요일을 나타내는 DAY_OF_WEEK 필드의 값입니다. |
static int |
SECOND
get 및 set 를 위한 필드치로, 초를 나타냅니다. |
static int |
SEPTEMBER
9 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
SUNDAY
일요일을 나타내는 DAY_OF_WEEK 필드의 값입니다. |
static int |
THURSDAY
목요일을 나타내는 DAY_OF_WEEK 필드의 값입니다. |
protected long |
time
이 달력으로 현재 설정되어 있을 때 각입니다. |
static int |
TUESDAY
화요일을 나타내는 DAY_OF_WEEK 필드의 값입니다. |
static int |
UNDECIMBER
13 번째의 달을 나타내는 MONTH 필드의 값입니다. |
static int |
WEDNESDAY
수요일을 나타내는 DAY_OF_WEEK 필드의 값입니다. |
static int |
WEEK_OF_MONTH
get 및 set 를 위한 필드치로, 현재의 달의 몇 주눈인지를 나타냅니다. |
static int |
WEEK_OF_YEAR
get 및 set 를 위한 필드치로, 현재의 해의 몇 주눈인지를 나타냅니다. |
static int |
YEAR
get 및 set 를 위한, 해를 나타내는 필드치입니다. |
static int |
ZONE_OFFSET
get 및 set 를 위한 필드치로, GMT 로부터 직접 계산한 오프셋(offset)를 밀리 세컨드 단위로 가리킵니다.
|
| 생성자의 개요 | |
protected |
Calendar ()
디폴트의 타임 존 및 로케일을 사용해 Calendar 를 작성합니다. |
protected |
Calendar (TimeZone zone,
Locale aLocale)
지정된 타임 존 및 로케일을 사용해 달력을 작성합니다. |
| 메소드의 개요 | |
abstract void |
add (int field,
int amount)
Date 의 연산 기능입니다. |
boolean |
after (Object when)
시간 필드 레코드를 비교합니다. |
boolean |
before (Object when)
시간 필드 레코드를 비교합니다. |
void |
clear ()
모든 시간 필드의 값을 클리어 합니다. |
void |
clear (int field)
지정된 시간 필드의 값을 클리어 합니다. |
Object |
clone ()
Cloneable 를 오버라이드(override) 합니다. |
protected void |
complete ()
시간 필드 리스트의 미설정필드에 값을 입금시킵니다. |
protected abstract void |
computeFields ()
현재의 밀리 세컨드의 시각치 time 를 fields[] 의 필드치로 변환합니다. |
protected abstract void |
computeTime ()
fields[] 의 현재의 필드치를 밀리 세컨드의 시각치 time 로 변환합니다. |
boolean |
equals (Object obj)
지정된 오브젝트와 달력을 비교합니다. |
int |
get (int field)
지정된 시간 필드의 값을 취득합니다. |
int |
getActualMaximum (int field)
현재의 일자에 대해서, 이 필드가 가질 수 있는 최대치를 돌려줍니다. |
int |
getActualMinimum (int field)
현재의 일자에 대해서, 이 필드가 가지고 돌아가는 최소치를 돌려줍니다. |
static Locale [] |
getAvailableLocales ()
Calendar 가 인스톨 되는 로케일의 리스트를 취득합니다. |
int |
getFirstDayOfWeek ()
주의 최초의 날이 무엇으로 있는지를 취득합니다. |
abstract int |
getGreatestMinimum (int field)
지정된 필드의 최소치가 변화하는 경우, 그 최대치를 취득합니다. |
static Calendar |
getInstance ()
디폴트의 타임 존과 로케일을 사용해 달력을 취득합니다. |
static Calendar |
getInstance (Locale aLocale)
디폴트의 타임 존과 지정된 로케일을 사용해 달력을 취득합니다. |
static Calendar |
getInstance (TimeZone zone)
지정된 타임 존과 디폴트의 로케일을 사용해 달력을 취득합니다. |
static Calendar |
getInstance (TimeZone zone,
Locale aLocale)
지정된 타임 존과 로케일을 사용해, 달력을 취득합니다. |
abstract int |
getLeastMaximum (int field)
지정된 필드의 최대치가 변화하는 경우, 그 최소치를 취득합니다. |
abstract int |
getMaximum (int field)
지정된 시간 필드의 최대치를 취득합니다. |
int |
getMinimalDaysInFirstWeek ()
해의 최초의 주에 필요한 최소 날짜를 취득합니다. |
abstract int |
getMinimum (int field)
지정된 시간 필드의 최소치를 취득합니다. |
Date |
getTime ()
Calendar 의 현재 시각을 취득합니다. |
long |
getTimeInMillis ()
Calendar 의 현재 시각을 long 로 취득합니다. |
TimeZone |
getTimeZone ()
타임 존을 취득합니다. |
int |
hashCode ()
이 달력의 해시 코드를 돌려줍니다. |
protected int |
internalGet (int field)
지정된 시간 필드의 값을 취득합니다. |
boolean |
isLenient ()
일자/시각의 해석이 엄밀하지 않은지 어떤지를 지정합니다. |
boolean |
isSet (int field)
지정된 시간 필드에 값이 설정되어 있는지 어떤지를 판별합니다. |
abstract void |
roll (int field,
boolean up)
시간 필드의 롤링 기능입니다. |
void |
roll (int field,
int amount)
시간 필드의 롤링 기능입니다. |
void |
set (int field,
int value)
시간 필드에, 지정된 값을 설정합니다. |
void |
set (int year,
int month,
int date)
년, 달, 일자의 필드에 값을 설정합니다. |
void |
set (int year,
int month,
int date,
int hour,
int minute)
년, 달, 일자, 때, 분의 필드에 값을 설정합니다. |
void |
set (int year,
int month,
int date,
int hour,
int minute,
int second)
년, 달, 일자, 시, 분, 초의 필드에 값을 설정합니다. |
void |
setFirstDayOfWeek (int value)
주의 최초의 날이 무엇으로 있는지를 설정합니다. |
void |
setLenient (boolean lenient)
일자/시각의 해석을 엄밀하게 실시할지 어떨지를 설정합니다. |
void |
setMinimalDaysInFirstWeek (int value)
해의 최초의 주에 필요한 최소 날짜를 설정합니다. |
void |
setTime (Date date)
Calendar 의 현재의 시각을, 지정된 Date 로 합니다. |
void |
setTimeInMillis (long millis)
Calendar 의 현재 시각을, 지정된 long 치로부터 설정합니다. |
void |
setTimeZone (TimeZone value)
지정된 타임 존치를 사용해 타임 존을 설정합니다. |
String |
toString ()
달력의 캐릭터 라인 표현을 돌려줍니다. |
| 클래스 java.lang. Object 에서 상속받은 메소드 |
finalize , getClass , notify , notifyAll , wait , wait , wait |
| 필드의 상세 |
public static final int ERA
get 및 set 를 위한 필드치로, 율리우스력의 AD 또는 BC 등의 연대를 나타냅니다. 이것은 달력 고유의 값입니다. 서브 클래스의 문서를 참조해 주세요.
GregorianCalendar.AD ,
GregorianCalendar.BC ,
정수 필드치 public static final int YEAR
get 및 set 를 위한, 해를 나타내는 필드치입니다. 이것은 달력 고유의 값입니다. 서브 클래스의 문서를 참조해 주세요.
public static final int MONTH
get 및 set 를 위한, 달을 나타내는 필드치입니다. 이것은 달력 고유의 값입니다. 해의 최초의 달은 JANUARY 로 , 0 이 됩니다. 마지막 달은 1 년의 달의 수에 의합니다.
JANUARY ,
FEBRUARY ,
MARCH ,
APRIL ,
MAY ,
JUNE ,
JULY ,
AUGUST ,
SEPTEMBER ,
OCTOBER ,
NOVEMBER ,
DECEMBER ,
UNDECIMBER ,
정수 필드치 public static final int WEEK_OF_YEAR
get 및 set 를 위한 필드치로, 현재의 해의 몇 주눈인지를 나타냅니다. getFirstDayOfWeek() 및 getMinimalDaysInFirstWeek() 로 정의되는 해의 최초의 주에는 값 1 이 사용됩니다. 서브 클래스에서는 해의 최초의 주부터 전날에 대해서 WEEK_OF_YEAR 의 값이 정의됩니다.
getFirstDayOfWeek() ,
getMinimalDaysInFirstWeek() ,
정수 필드치 public static final int WEEK_OF_MONTH
get 및 set 를 위한 필드치로, 현재의 달의 몇 주눈인지를 나타냅니다. getFirstDayOfWeek() 및 getMinimalDaysInFirstWeek() 로 정의되는 달의 최초의 주에는 값 1 이 사용됩니다. 서브 클래스에서는 달의 최초의 주부터 전날에 대해서 WEEK_OF_MONTH 의 값이 정의됩니다.
getFirstDayOfWeek() ,
getMinimalDaysInFirstWeek() ,
정수 필드치 public static final int DATE
get 및 set 를 위한 필드치로, 달의 날을 나타냅니다. 이것은 DAY_OF_MONTH 와 같게 됩니다. 달의 최초의 날에는 값 1 이 사용됩니다.
DAY_OF_MONTH ,
정수 필드치 public static final int DAY_OF_MONTH
get 및 set 를 위한 필드치로, 달의 날을 나타냅니다. 이것은 DATE 와 같게 됩니다. 달의 최초의 날에는 값 1 이 사용됩니다.
DATE ,
정수 필드치 public static final int DAY_OF_YEAR
get 및 set 를 위한 필드치로, 현재의 해의 며칠눈인지를 나타냅니다. 해의 최초의 날에는 값 1 이 사용됩니다.
public static final int DAY_OF_WEEK
get 및 set 를 위한 필드치로, 요일을 나타냅니다. 이 필드의 값은 SUNDAY,MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY, 및 SATURDAY 가 됩니다.
SUNDAY ,
MONDAY ,
TUESDAY ,
WEDNESDAY ,
THURSDAY ,
FRIDAY ,
SATURDAY ,
정수 필드치 public static final int DAY_OF_WEEK_IN_MONTH
get 및 set 를 위한 필드치로, 현재의 달의 몇번눈의 요일인지를 나타냅니다. DAY_OF_WEEK 필드와 함께 사용하면(자), 달의 날을 일의로 지정할 수 있습니다. WEEK_OF_MONTH 및 WEEK_OF_YEAR 과는 달리, 이 필드의 값은 getFirstDayOfWeek() 또는 getMinimalDaysInFirstWeek() 에는 의존하지 않습니다. DAY_OF_MONTH 1 에서 7 은 항상 DAY_OF_WEEK_IN_MONTH 1 에 대응합니다. 8 에서 14 는 DAY_OF_WEEK_IN_MONTH 2 에 대응해, 이하와 같이 됩니다. DAY_OF_WEEK_IN_MONTH 0 은 DAY_OF_WEEK_IN_MONTH 1 의 전의 주를 나타냅니다. 부의 값은 월말부터 거슬러 올라가 셀 수 있기 (위해)때문에, 달의 마지막 날 요일은 DAY_OF_WEEK = SUNDAY, DAY_OF_WEEK_IN_MONTH = -1 와 지정됩니다. 부의 값은 거슬러 올라가 계산되기 (위해)때문에, 통상은 당월내의 정의 값과는 다른 위치에 배치됩니다. 예를 들어, 1 개월이 31 일의 경우,DAY_OF_WEEK_IN_MONTH -1 는 DAY_OF_WEEK_IN_MONTH 5 및 4 의 최후와 오버랩 합니다.
DAY_OF_WEEK ,
WEEK_OF_MONTH ,
정수 필드치 public static final int AM_PM
get 및 set 를 위한 필드치로,HOUR 가 정오보다 전일까 다음에 있는지를 나타냅니다. 예를 들어,10:04:15. 250 PM 의 경우,AM_PM 는 PM 가 됩니다.
AM ,
PM ,
HOUR ,
정수 필드치 public static final int HOUR
get 및 set 를 위한 필드치로, 오전 또는 오후의 몇시인지를 나타냅니다. HOUR 는 12 시간제입니다. 예를 들어,10:04:15. 250 PM 의 경우,HOUR 는 10 이 됩니다.
AM_PM ,
HOUR_OF_DAY ,
정수 필드치 public static final int HOUR_OF_DAY
get 및 set 를 위한 필드치로, 시각을 나타냅니다. HOUR_OF_DAY 는 24 시간제입니다. 예를 들어,10:04:15. 250 PM 의 경우,HOUR_OF_DAY 는 22 가 됩니다.
HOUR ,
정수 필드치 public static final int MINUTE
get 및 set 를 위한 필드치로, 분을 나타냅니다. 예를 들어,10:04:15. 250 PM 의 경우,MINUTE 는 4 가 됩니다.
public static final int SECOND
get 및 set 를 위한 필드치로, 초를 나타냅니다. 예를 들어,10:04:15. 250 PM 의 경우,SECOND 는 15 가 됩니다.
public static final int MILLISECOND
get 및 set 를 위한 필드치로, 밀리 세컨드를 나타냅니다. 예를 들어,10:04:15. 250 PM 의 경우,MILLISECOND 는 250 이 됩니다.
public static final int ZONE_OFFSET
get 및 set 를 위한 필드치로, GMT 로부터 직접 계산한 오프셋(offset)를 밀리 세컨드 단위로 가리킵니다.
TimeZone 구현 서브 클래스가, GMT 오프셋(offset)의 역사적 변화를 서포트하는 경우, 이 필드는 이 Calendar 의 타임 존의 정확한 GMT 오프셋(offset)치를 반영합니다.
public static final int DST_OFFSET
get 및 set 를 위한 필드치로, 서머타임의 오프셋(offset)를 밀리 세컨드 단위로 가리킵니다.
TimeZone 구현 서브 클래스가, 서머타임의 스케줄의 역사적 변화를 서포트하는 경우, 이 필드는 이 Calendar 의 타임 존의 정확한 서머타임의 오프셋(offset)치를 반영합니다.
public static final int FIELD_COUNT
get 및 set 에 의해 식별되는 중복 하지 않는 필드의 수를 나타냅니다. 필드수의 범위는 0..FIELD_COUNT-1 입니다.
public static final int SUNDAY
DAY_OF_WEEK 필드의 값입니다.
public static final int MONDAY
DAY_OF_WEEK 필드의 값입니다.
public static final int TUESDAY
DAY_OF_WEEK 필드의 값입니다.
public static final int WEDNESDAY
DAY_OF_WEEK 필드의 값입니다.
public static final int THURSDAY
DAY_OF_WEEK 필드의 값입니다.
public static final int FRIDAY
DAY_OF_WEEK 필드의 값입니다.
public static final int SATURDAY
DAY_OF_WEEK 필드의 값입니다.
public static final int JANUARY
MONTH 필드의 값입니다.
public static final int FEBRUARY
MONTH 필드의 값입니다.
public static final int MARCH
MONTH 필드의 값입니다.
public static final int APRIL
MONTH 필드의 값입니다.
public static final int MAY
MONTH 필드의 값입니다.
public static final int JUNE
MONTH 필드의 값입니다.
public static final int JULY
MONTH 필드의 값입니다.
public static final int AUGUST
MONTH 필드의 값입니다.
public static final int SEPTEMBER
MONTH 필드의 값입니다.
public static final int OCTOBER
MONTH 필드의 값입니다.
public static final int NOVEMBER
MONTH 필드의 값입니다.
public static final int DECEMBER
MONTH 필드의 값입니다.
public static final int UNDECIMBER
MONTH 필드의 값입니다. GregorianCalendar 에서는 이 값은 사용하지 않습니다만, 음력에 사용합니다.
public static final int AM
AM_PM 필드의 값입니다.
public static final int PM
AM_PM 필드의 값입니다.
protected int[] fields
ERA 로부터 DST_OFFSET 까지의,FIELD_COUNT 정수치의 배열입니다.
protected boolean[] isSet
ERA 로부터 DST_OFFSET 까지의,FIELD_COUNT boolean 치의 배열입니다.
protected long time
isTimeSet protected boolean isTimeSet
time 의 값이 유효한 경우는 true 입니다. field[] 의 항목을 변경하는 것으로, time 는 무효가 됩니다.
time protected boolean areFieldsSet
fields[] 가 현재 설정되어 있을 때 각과 동기를 잡고 있는 경우는 true 입니다. false 의 경우는 다음에 필드의 값을 취득하려고 했을 때에,time 의 현재가로부터의 모든 필드가 재계산됩니다.
| 생성자의 상세 |
protected Calendar()
TimeZone.getDefault()
protected Calendar(TimeZone zone,
Locale aLocale)
zone - 사용하는 타임 존aLocale - 주의 데이터에 사용하는 로케일| 메소드의 상세 |
public static Calendar getInstance()
Calendar 는 디폴트 로케일을 가지는 디폴트 타임 존의 현재 시각에 근거하고 있습니다.
public static Calendar getInstance(TimeZone zone)
Calendar 는 디폴트 로케일을 가지는 지정된 타임 존의 현재 시각에 근거하고 있습니다.
zone - 사용하는 타임 존
public static Calendar getInstance(Locale aLocale)
Calendar 는 지정된 로케일을 가지는 디폴트의 타임 존의 현재 시각에 근거하고 있습니다.
aLocale - 주의 데이터에 사용하는 로케일
public static Calendar getInstance(TimeZone zone,
Locale aLocale)
Calendar 는 지정된 로케일을 가지는 지정된 타임 존의 현재 시각에 근거하고 있습니다.
zone - 사용하는 타임 존aLocale - 주의 데이터에 사용하는 로케일
public static Locale [] getAvailableLocales()
protected abstract void computeTime()
fields[] 의 현재의 필드치를 밀리 세컨드의 시각치 time 로 변환합니다.
protected abstract void computeFields()
time 를 fields[] 의 필드치로 변환합니다. 이것에 의해, 시간 필드의 값을, 달력으로 설정되어 있는 새로운 시각과 동기 시킬 수가 있습니다. time 는 최초로 재계산되지 않습니다. time 를 재계산하고 나서 필드를 재계산하려면 ,complete 메소드를 호출합니다.
complete() public final Date getTime()
setTime(java.util.Date) ,
getTimeInMillis() public final void setTime(Date date)
주: Date(Long.MAX_VALUE) 또는 Date(Long.MIN_VALUE) 로 setTime() 를 호출하면(자),get() 로부터 부정확한 필드치가 생기는 일이 있습니다.
date - 지정된 DategetTime() ,
setTimeInMillis(long) public long getTimeInMillis()
getTime() ,
setTimeInMillis(long) public void setTimeInMillis(long millis)
millis - 신기원으로부터의 UTC 밀리 세컨드치로 나타내지는 새로운 시각setTime(java.util.Date) ,
getTimeInMillis() public int get(int field)
field - 지정된 시간 필드
ArrayIndexOutOfBoundsException - 지정된 필드가 범위외의 경우 (field < 0 || field >= FIELD_COUNT)protected final int internalGet(int field)
field - 지정된 시간 필드
public void set(int field,
int value)
field - 지정된 시간 필드value - 지정된 시간 필드로 설정하는 값
ArrayIndexOutOfBoundsException - 지정된 필드가 범위외의 경우 (field < 0 || field >= FIELD_COUNT)
public final void set(int year,
int month,
int date)
clear 를 호출합니다.
year - YEAR 시간 필드로 설정하는 값month - MONTH 시간 필드로 설정하는 값. Month 치는 0 으로부터 시작된다. 즉, 0 은 1 월date - DATE 시간 필드로 설정하는 값
public final void set(int year,
int month,
int date,
int hour,
int minute)
clear 를 호출합니다.
year - YEAR 시간 필드로 설정하는 값month - MONTH 시간 필드로 설정하는 값. Month 치는 0 으로부터 시작된다. 즉, 0 은 1 월date - DATE 시간 필드로 설정하는 값hour - HOUR_OF_DAY 시간 필드로 설정하는 값minute - MINUTE 시간 필드로 설정하는 값
public final void set(int year,
int month,
int date,
int hour,
int minute,
int second)
clear 를 호출합니다.
year - YEAR 시간 필드로 설정하는 값month - MONTH 시간 필드로 설정하는 값. Month 치는 0 으로부터 시작된다. 즉, 0 은 1 월date - DATE 시간 필드로 설정하는 값hour - HOUR_OF_DAY 시간 필드로 설정하는 값minute - MINUTE 시간 필드로 설정하는 값second - SECOND 시간 필드로 설정하는 값public final void clear()
public final void clear(int field)
field - 클리어 할 시간 필드public final boolean isSet(int field)
protected void complete()
public boolean equals(Object obj)
null 가 아니고, 이 오브젝트와 같은 달력을 나타내는 Calendar 오브젝트인 경우에만, 결과는 true 가 됩니다.
Object 내의 equals obj - 비교 대상의 오브젝트
true, 그렇지 않은 경우는 falseObject.hashCode() ,
Hashtable public int hashCode()
Object 내의 hashCode Object.equals(java.lang.Object) ,
Hashtable public boolean before(Object when)
when - 이 Calendar 라고 비교되는 Calendar
public boolean after(Object when)
when - 이 Calendar 라고 비교되는 Calendar
public abstract void add(int field,
int amount)
add(Calendar.DATE, -5)
field - 시간 필드amount - 필드에 추가되는 일자 또는 시각의 양
public abstract void roll(int field,
boolean up)
roll(Calendar.DATE, true). 해 또는 Calendar.YEAR 필드를 움직이면(자), 해의 값은 1 으로 getMaximum(Calendar.YEAR)로 돌려주어지는 값의 범위의 해로 바뀝니다. 달 또는 Calendar.MONTH 필드를 움직이면(자), 일자등의 다른 필드가 모순을 일으키는 경우가 있으므로, 그 경우는 그러한 필드를 변경할 필요가 있습니다. 예를 들어, 일자 01/31/96 의 달을 움직이면(자), 결과는 02/29/96 됩니다. 날의 시간 또는 Calendar.HOUR_OF_DAY 필드를 움직이면(자), 때의 값은 0 으로 23 의 범위의 값 (제로 베이스)으로 바뀝니다.
field - 시간 필드up - 지정된 시간 필드의 값을 위에 움직이는지 아래에 움직이는지를 지정한다. 위에 움직이는 경우는 true, 그렇지 않은 경우는 false 를 사용하는add(int, int) ,
set(int, int)
public void roll(int field,
int amount)
field - 시간 필드amount - field 에 가산하는 지정된 양add(int, int) ,
set(int, int) public void setTimeZone(TimeZone value)
value - 지정된 타임 존public TimeZone getTimeZone()
public void setLenient(boolean lenient)
DateFormat.setLenient(boolean) public boolean isLenient()
public void setFirstDayOfWeek(int value)
value - 지정된 주의 최초의 날public int getFirstDayOfWeek()
public void setMinimalDaysInFirstWeek(int value)
value - 년의 최초의 주에 필요한 지정된 최소 날짜public int getMinimalDaysInFirstWeek()
public abstract int getMinimum(int field)
field - 지정된 시간 필드
public abstract int getMaximum(int field)
field - 지정된 시간 필드
public abstract int getGreatestMinimum(int field)
field - 지정된 시간 필드
public abstract int getLeastMaximum(int field)
field - 지정된 시간 필드
public int getActualMinimum(int field)
field - 최소치를 판정하는 필드
public int getActualMaximum(int field)
field - 최대치를 판정하는 필드
public Object clone()
Object 내의 clone Cloneable public String toString()
null 로는 되지 않습니다.
Object 내의 toString
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.