|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object
|
+--java.util.Calendar
|
+--java.util.GregorianCalendar
GregorianCalendar 는 Calendar 의 구상 서브 클래스이며, 세계의 대부분의 지역에서 사용되는 표준적인 달력을 제공합니다.
표준 (그레고리오) 달력에는 BC (기원 전)와 AD (기원 후)라고 하는 구분이 있습니다.
이 구현에서는 1 개의 변환기를 처리합니다. 이 변환기는 디폴트 값에 의해, 태양력이 제정된 날 (일부의 나라에서는 1582 년 10 월 15 일, 그 외의 나라에서는 그것 이후)에 대응하고 있습니다. 조정일은 setGregorianChange() 를 호출하는 것에 의해 호출측에서 변경할 수 있습니다.
역사적으로, 태양력을 최초로 채용한 나라들에서는 1582 년 10 월 4 일의 후에 1582 년 10 월 15 일이 계속되었습니다. 이 달력은 이것을 정확하게 모델화하고 있습니다. 태양력에의 변경일의 전은 GregorianCalendar 에서는 율리우스력을 구현하고 있습니다. 태양력과 율리우스력의 유일한 차이는 윤년의 규칙입니다. 율리우스력은 4 년마다 윤년을 지정합니다만, 태양력으로는 100 으로 나뉘어 떨어져, 한편 400 으로 나뉘어 떨어지지 않는 해를 윤년으로 하지 않습니다.
GregorianCalendar 는 「예기적」태양력 및 율리우스력을 구현합니다. 즉, 일자의 계산에서는 현재의 규칙을 무한의 과거 혹은 미래를 향해 적용합니다. 이 때문에,GregorianCalendar 는 모든 해에 대해 일관한 결과를 생성하기 위해서 사용할 수 있습니다. 다만,GregorianCalendar 를 사용해 얻을 수 있던 일자는 역사적으로, 현대와 같은 율리우스력이 채용되고 AD 4 년 3 월 1 일 이후의 일자만이 정확합니다. 이 일자보다 전에는 윤년의 규칙은 불규칙하게 적용되고 있어 BC 45 년 이전에는 율리우스력은 존재마저 하고 있지 않았습니다.
태양력의 제정보다 전은 설날은 3 월 25 일이었습니다. 혼란을 피하기 위해서(때문에), 이 달력에서는 항상 1 월 1 일을 사용합니다. 필요하면, 태양력보다 전날부에 대해, 1 월 1 일부터 3 월 24 일간의 날에 조정할 수가 있습니다.
WEEK_OF_YEAR 필드에 대해서 계산되는 값의 범위는 1 에서 53 입니다. 해의 제 1 주는 그 해로부터 적어도 getMinimalDaysInFirstWeek() 일을 포함한 getFirstDayOfWeek() 로 시작되는 가장 빠른 7 일간입니다. 이와 같이 제 1 주는 getMinimalDaysInFirstWeek(),getFirstDayOfWeek() 의 값, 및 1 월 1 일의 요일에 의해 변화합니다. 1 년의 제 1 주부터 다음 해의 제 1 주까지의 주는 필요에 따라서 2 에서 52 또는 53 까지 순서에 번호를 붙일 수 있습니다.
예를 들어, 1998 년 1 월 1 일은 목요일이었습니다. getFirstDayOfWeek() 가 MONDAY 로 getMinimalDaysInFirstWeek() 가 4 의 경우 (이것들은 ISO 8601 및 다수의 나라의 표준), 1998 년의 제 1 주는 1997년 12 월 29 일부터, 1998 년 1 월 4 일까지입니다. 다만,getFirstDayOfWeek() 가 SUNDAY 의 경우, 1998 년의 제 1 주는 1998 년 1 월 4 일부터, 1998 년 1 월 10 일까지입니다. 1998 년의 최초의 3 일간은 1997 년의 제 53 주에 접어듭니다.
WEEK_OF_MONTH 필드에 대해서 계산되는 값의 범위는 0 에서 6 입니다. 달의 제 1 주 (WEEK_OF_MONTH = 1 의 날)는 그 달에 적어도 getMinimalDaysInFirstWeek() 일간 연속하는 가장 빠른 주가 되어,getFirstDayOfWeek() 의 전날까지입니다. 해의 제 1 주와는 달라, 달의 제 1 주는 7 일보다 짧은 일이 있어,getFirstDayOfWeek() 로 시작될 필요는 없고, 전의 달의 날은 포함되지 않습니다. 제 1 주보다 전의 달의 날에는 WEEK_OF_MONTH 의 값은 0 이 됩니다.
예를 들어,getFirstDayOfWeek() 가 SUNDAY 로 getMinimalDaysInFirstWeek() 가 4 의 경우, 1998 년 1 월의 제 1 주는 1 월 4 나날 요일부터 1 월 10 일 토요일이 됩니다. 이러한 날의 WEEK_OF_MONTH 의 값은 1 입니다. 1 월 1 일 목요일부터 1 월 3 일 토요일의 WEEK_OF_MONTH 의 값은 0 입니다. getMinimalDaysInFirstWeek() 의 값이 3 으로 변경되면(자), 1 월 1 일부터 1 월 3 일의 WEEK_OF_MONTH 의 값은 1 이 됩니다.
례:
// get the supported ids for GMT-08:00 (Pacific Standard Time)
String[] ids = TimeZone.getAvailableIDs(-8 * 60 * 60 * 1000);
// if no ids were returned, something is wrong. get out.
if (ids.length == 0)
System.exit(0);
// begin output
System.out.println("Current Time");
// create a Pacific Standard Time time zone
SimpleTimeZone pdt = new SimpleTimeZone(-8 * 60 * 60 * 1000, ids[0]);
// set up rules for daylight savings time
pdt.setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2 * 60 * 60 * 1000);
pdt.setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2 * 60 * 60 * 1000);
// create a GregorianCalendar with the Pacific Daylight time zone
// and the current date and time
Calendar calendar = new GregorianCalendar(pdt);
Date trialTime = new Date();
calendar.setTime(trialTime);
// print out a bunch of interesting things
System.out.println("ERA: " + calendar.get(Calendar.ERA));
System.out.println("YEAR: " + calendar.get(Calendar.YEAR));
System.out.println("MONTH: " + calendar.get(Calendar.MONTH));
System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR));
System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH));
System.out.println("DATE: " + calendar.get(Calendar.DATE));
System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH));
System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR));
System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK));
System.out.println("DAY_OF_WEEK_IN_MONTH: "
+ calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH));
System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM));
System.out.println("HOUR: " + calendar.get(Calendar.HOUR));
System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY));
System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE));
System.out.println("SECOND: " + calendar.get(Calendar.SECOND));
System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND));
System.out.println("ZONE_OFFSET: "
+ (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000)));
System.out.println("DST_OFFSET: "
+ (calendar.get(Calendar.DST_OFFSET)/(60*60*1000)));
System.out.println("Current Time, with hour reset to 3");
calendar.clear(Calendar.HOUR_OF_DAY); // so doesn't override
calendar.set(Calendar.HOUR, 3);
System.out.println("ERA: " + calendar.get(Calendar.ERA));
System.out.println("YEAR: " + calendar.get(Calendar.YEAR));
System.out.println("MONTH: " + calendar.get(Calendar.MONTH));
System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR));
System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH));
System.out.println("DATE: " + calendar.get(Calendar.DATE));
System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH));
System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR));
System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK));
System.out.println("DAY_OF_WEEK_IN_MONTH: "
+ calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH));
System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM));
System.out.println("HOUR: " + calendar.get(Calendar.HOUR));
System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY));
System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE));
System.out.println("SECOND: " + calendar.get(Calendar.SECOND));
System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND));
System.out.println("ZONE_OFFSET: "
+ (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000))); // in hours
System.out.println("DST_OFFSET: "
+ (calendar.get(Calendar.DST_OFFSET)/(60*60*1000))); // in hours
Calendar ,
TimeZone ,
직렬화 된 형식 | 필드의 개요 | |
static int |
AD
서기 (서기)를 나타내는 ERA 필드의 값이며, CE 라고도 불립니다. |
static int |
BC
서기 (BC)보다 전의 기간을 나타내는 ERA 필드의 값이며, BCE 라고도 불립니다. |
| 클래스 java.util. Calendar 에서 상속받은 필드 |
AM , AM_PM , APRIL , areFieldsSet , AUGUST , DATE , DAY_OF_MONTH , DAY_OF_WEEK , DAY_OF_WEEK_IN_MONTH , DAY_OF_YEAR , DECEMBER , DST_OFFSET , ERA , FEBRUARY , FIELD_COUNT , fields , FRIDAY , HOUR , HOUR_OF_DAY , isSet , isTimeSet , JANUARY , JULY , JUNE , MARCH , MAY , MILLISECOND , MINUTE , MONDAY , MONTH , NOVEMBER , OCTOBER , PM , SATURDAY , SECOND , SEPTEMBER , SUNDAY , THURSDAY , time , TUESDAY , UNDECIMBER , WEDNESDAY , WEEK_OF_MONTH , WEEK_OF_YEAR , YEAR , ZONE_OFFSET |
| 생성자의 개요 | |
GregorianCalendar ()
디폴트 로케일로 디폴트 타임 존의 현재 시각에 근거해 디폴트의 GregorianCalendar 를 구축합니다. |
|
GregorianCalendar (int year,
int month,
int date)
디폴트 로케일로 디폴트 타임 존의 지정된 일자에 근거해 GregorianCalendar 를 구축합니다. |
|
GregorianCalendar (int year,
int month,
int date,
int hour,
int minute)
디폴트 로케일로 디폴트 타임 존의 지정된 일자와 시각에 근거해 GregorianCalendar 를 구축합니다. |
|
GregorianCalendar (int year,
int month,
int date,
int hour,
int minute,
int second)
디폴트 로케일로 디폴트 타임 존의 지정된 일자와 시각에 근거해 GregorianCalendar 를 구축합니다. |
|
GregorianCalendar (Locale aLocale)
지정된 로케일로 디폴트 타임 존의 현재 시각에 근거해 GregorianCalendar 를 구축합니다. |
|
GregorianCalendar (TimeZone zone)
디폴트 로케일로 지정된 타임 존의 현재 시각에 근거해 GregorianCalendar 를 구축합니다. |
|
GregorianCalendar (TimeZone zone,
Locale aLocale)
지정된 로케일로 지정된 타임 존의 현재 시각에 근거해 GregorianCalendar 를 구축합니다. |
|
| 메소드의 개요 | |
void |
add (int field,
int amount)
달력의 규칙에 근거해, 지정된 (부호 첨부의) 시간량을, 지정된 시간 필드에 가세합니다. |
protected void |
computeFields ()
Calendar 를 오버라이드(override) 합니다. |
protected void |
computeTime ()
Calendar 를 오버라이드(override) 합니다. |
boolean |
equals (Object obj)
이 GregorianCalendar 와 오브젝트 참조를 비교합니다. |
int |
getActualMaximum (int field)
현재의 일자에 대한, 이 필드가 가질 수 있는 최대치를 돌려줍니다. |
int |
getActualMinimum (int field)
현재의 일자에 대한, 이 필드가 가질 수 있는 최소치를 돌려줍니다. |
int |
getGreatestMinimum (int field)
지정된 필드가 변화하는 경우, 그 최대치를 돌려줍니다. |
Date |
getGregorianChange ()
태양력의 변경일을 취득합니다. |
int |
getLeastMaximum (int field)
지정된 필드가 변화하는 경우, 그 최소의 최대치를 돌려줍니다. |
int |
getMaximum (int field)
지정된 필드의 최대치 (예를 들어, 태양력의 DAY_OF_MONTH 에서는 31)를 돌려줍니다. |
int |
getMinimum (int field)
지정된 필드의 최소치 (예를 들어, 태양력의 DAY_OF_MONTH 에서는 1)를 돌려줍니다. |
int |
hashCode ()
해시 코드를 오버라이드(override) 합니다. |
boolean |
isLeapYear (int year)
지정된 해가, 윤년인가 어떤가를 판정합니다. |
void |
roll (int field,
boolean up)
큰 필드를 변경하지 않고 로 지정된 시간 필드의 1 개의 단위의 시간을 위 또는 아래에 가산 또는 감산합니다. |
void |
roll (int field,
int amount)
큰 필드를 변경하지 않고 지정된 양을 필드에 가산합니다. |
void |
setGregorianChange (Date date)
GregorianCalendar 의 변경일을 설정합니다. |
| 클래스 java.util. Calendar 에서 상속받은 메소드 |
after , before , clear , clear , clone , complete , get , getAvailableLocales , getFirstDayOfWeek , getInstance , getInstance , getInstance , getInstance , getMinimalDaysInFirstWeek , getTime , getTimeInMillis , getTimeZone , internalGet , isLenient , isSet , set , set , set , set , setFirstDayOfWeek , setLenient , setMinimalDaysInFirstWeek , setTime , setTimeInMillis , setTimeZone , toString |
| 클래스 java.lang. Object 에서 상속받은 메소드 |
finalize , getClass , notify , notifyAll , wait , wait , wait |
| 필드의 상세 |
public static final int BC
ERA 필드의 값이며, BCE 라고도 불립니다. BC 로부터 AD 에는 다음과 같이 이행 합니다...., 2 BC, 1 BC, 1 AD, 2 AD,...
Calendar.ERA ,
정수 필드치 public static final int AD
ERA 필드의 값이며, CE 라고도 불립니다. BC 로부터 AD 에는 다음과 같이 이행 합니다...., 2 BC, 1 BC, 1 AD, 2 AD,...
Calendar.ERA ,
정수 필드치 | 생성자의 상세 |
public GregorianCalendar()
public GregorianCalendar(TimeZone zone)
zone - 지정된 타임 존public GregorianCalendar(Locale aLocale)
aLocale - 지정된 로케일
public GregorianCalendar(TimeZone zone,
Locale aLocale)
zone - 지정된 타임 존aLocale - 지정된 로케일
public GregorianCalendar(int year,
int month,
int date)
year - 달력의 YEAR 시간 필드로 설정하는 값month - 달력의 MONTH 시간 필드로 설정하는 값. month 의 값은 0 으로부터 시작되는 (예: 0 은 1 월)date - 달력의 DATE 시간 필드로 설정하는 값
public GregorianCalendar(int year,
int month,
int date,
int hour,
int minute)
year - 달력의 YEAR 시간 필드로 설정하는 값month - 달력의 MONTH 시간 필드로 설정하는 값. month 의 값은 0 으로부터 시작되는 (예: 0 은 1 월)date - 달력의 DATE 시간 필드로 설정하는 값hour - 달력의 HOUR_OF_DAY 시간 필드로 설정하는 값minute - 달력의 MINUTE 시간 필드로 설정하는 값
public GregorianCalendar(int year,
int month,
int date,
int hour,
int minute,
int second)
year - 달력의 YEAR 시간 필드로 설정하는 값month - 달력의 MONTH 시간 필드로 설정하는 값. month 의 값은 0 으로부터 시작되는 (예: 0 은 1 월)date - 달력의 DATE 시간 필드로 설정하는 값hour - 달력의 HOUR_OF_DAY 시간 필드로 설정하는 값minute - 달력의 MINUTE 시간 필드로 설정하는 값second - 달력의 SECOND 시간 필드로 설정하는 값| 메소드의 상세 |
public void setGregorianChange(Date date)
순수한 율리우스력을 취득하려면 , 변경일을 Date(Long.MAX_VALUE) 로 설정합니다. 순수한 그레고리오력을 취득하려면 , 변경일을 Date(Long.MIN_VALUE) 로 설정합니다.
date - 태양력에의 변경 일자public final Date getGregorianChange()
public boolean isLeapYear(int year)
year - 지정하는 해
public boolean equals(Object obj)
Calendar 내의 equals obj - 비교 대상의 오브젝트 참조
obj 에 동일한 경우는 true, 그렇지 않은 경우는 falsepublic int hashCode()
Calendar 내의 hashCode
public void add(int field,
int amount)
Add rule 1. 호출이 필드에서 발생한 모듈로 오버플로우 amount 가 되기 전에, 호출로 필드의 값을 깎은 뒤의 field 의 값입니다. 오버플로우는 필드의 값이 범위를 넘어, 그 결과다음의 큰 필드가 증분 또는 감 분 되어 필드의 값이 그 범위에 들어가도록(듯이) 조정되었을 경우에 발생합니다.
Add rule 2. 작은 필드가 불변식이다고 예상되는 경우에,field 가 변경되고 나서 최소치 또는 최대치가 변경되었기 때문에, 그 전의 값과 동일하게 안 되면 필드의 값은 그 예상되는 값으로 할 수 있을 뿐(만큼) 가까운 시일내에 되도록(듯이) 조정됩니다. 작은 필드는 작은 시간의 단위를 나타냅니다. HOUR 는 DAY_OF_MONTH 보다 작은 필드입니다. 불변식은 아니라고 예상되는 작은 필드는 조정되지 않습니다. 달력 시스템에서는 불변식이다고 예상되는 필드가 판단됩니다.
Calendar 내의 add field - 시간 필드amount - 필드에 추가되는 일자 또는 시각의 양
IllegalArgumentException - 인식할 수 없는 필드가 지정되었을 경우
public void roll(int field,
boolean up)
예: 1999 년 12 월 31 일에 당초 설정된 GregorianCalendar 를 생각합니다. roll(Calendar.MONTH, true) 를 호출하면(자), 달력이 1999 년 1 월 31 일로 설정됩니다. Year 필드는 MONTH 보다 큰 필드이므로 변경되지 않습니다.
Calendar 내의 roll up - 지정된 시간 필드의 값을 위에 움직이는지 아래에 움직이는지를 지정한다. 위에 움직이는 경우는 true, 그렇지 않은 경우는 false 를 사용하는field - 시간 필드
IllegalArgumentException - 인식할 수 없는 필드치가 지정되었을 경우add(int, int) ,
Calendar.set(int, int)
public void roll(int field,
int amount)
예: 1999 년 8 월 31 일에 당초 설정된 GregorianCalendar 를 생각합니다. roll(Calendar.MONTH, 8) 를 호출하면(자), 달력이 1999 년 4 월 30 일로 설정됩니다. GregorianCalendar 를 사용하면(자),DAY_OF_MONTH 필드는 4 월에 있어 31 일이 되지 않습니다. DAY_OF_MONTH 는 가장 가까운 유효치인 30 으로 설정됩니다. YEAR 필드에서는 MONTH 필드보다 크기 때문에, 1999 의 값을 유지합니다.
예: 최초로 1999 년 6 월 6 나날 요일로 설정된 GregorianCalendar 를 생각합니다. roll(Calendar.WEEK_OF_MONTH, -1) 를 호출하면(자), 달력이 1999 년 6 월 1 일 화요일로 설정되어add(Calendar.WEEK_OF_MONTH, -1) 를 호출하면(자), 달력이 1999 년 5 월 30 나날 요일로 설정됩니다. 이것은 롤 규칙으로 추가의 제한이 더해지기 (위해)때문에입니다. WEEK_OF_MONTH 가 롤 될 때 MONTH 를 변경해야 하지는 않습니다. add rule 1 과 함께 사용하면(자), 결과의 일자는 6 월 1 일 화요일부터 6 월 5 일 토요일까지 될 필요가 있습니다. add rule 2 에 따라,WEEK_OF_MONTH 를 변경할 경우에 불변식 DAY_OF_WEEK 가, 일요일에 가장 가까운 가능치인 화요일로 설정됩니다 (일요일이 주의 최초의 날의 경우).
Calendar 내의 roll field - 시간 필드amount - field 에 추가하는 지정된 양add(int, int) ,
Calendar.set(int, int) public int getMinimum(int field)
Calendar 내의 getMinimum field - 지정된 시간 필드
public int getMaximum(int field)
Calendar 내의 getMaximum field - 지정된 시간 필드
public int getGreatestMinimum(int field)
Calendar 내의 getGreatestMinimum field - 지정된 시간 필드
public int getLeastMaximum(int field)
Calendar 내의 getLeastMaximum field - 지정된 시간 필드
public int getActualMinimum(int field)
Calendar 내의 getActualMinimum field - 최소치를 판정하는 필드
public int getActualMaximum(int field)
Calendar 내의 getActualMaximum field - 최대치를 판정하는 필드
protected void computeFields()
complete 메소드를 호출합니다.
Calendar 내의 computeFields Calendar.complete() protected void computeTime()
Calendar 내의 computeTime IllegalArgumentException - 무효인 필드가 있는 경우
|
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.