|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object
|
+--java.util.TimeZone
|
+--java.util.SimpleTimeZone
SimpleTimeZone 는 태양력에 사용되는 타임 존을 나타내는 TimeZone 의 구상 서브 클래스입니다. 클래스는 「직접 계산된 오프셋(offset)」라고 불리는 GMT 로부터의 오프셋(offset), 및 서머타임의 개시 규칙 및 종료 규칙을 보관 유지합니다. 각각의 단일치를 보관 유지할 뿐(만큼)이므로, 서머타임의 실시 개시시에 setStartYear 메소드가 year 를 지정할 수 있는 것을 제외해, GMT 및 서머타임부터의 오프셋(offset)로 역사상의 변경을 취급할 수 없습니다.
서머타임을 갖추는 SimpleTimeZone 를 구축하려면 , start-rule 와 end-rule 의 규칙 세트로 스케줄을 기술합니다. 서머타임이 개시 또는 종료하는 일자는 month, day-of-month 및 day-of-week 치를 조합해 지정합니다. month 치는 Calendar.MARCH 등의, 달력 MONTH 필드치로, day-of-week 치는 SUNDAY 등의, 달력 DAY_OF_WEEK 치로 나타냅니다. 값의 편성의 의미는 다음과 같습니다.
MARCH 에, day-of-month 를 1 에, day-of-week 를 0 으로 설정합니다. DAY_OF_WEEK 필드치를 설정합니다. 예를 들어, 4 월의 제 2 일요일을 지정하려면 , month 를 APRIL 에, day-of-month 를 8 에, day-of-week 를 SUNDAY 로 설정합니다. MARCH 에, day-of-month 는 -21, day-of-week 는 -WEDNESDAY 로 설정합니다. DAY_OF_WEEK 치에, day-of-month 를 -1 로 설정합니다. 예를 들어, 10 월의 마지막 날 요일을 지정하려면 , month 를 OCTOBER 로 설정해, day-of-week 를 SUNDAY 에, day-of-month 를 -1 로 합니다. WALL_TIME ,STANDARD_TIME 및 UTC_TIME 의 3 종류의 mode 가 있습니다. 예를 들어, 서머타임이, 월 (벽) 시계 시간의 오전 2 시에 종료하는 경우,WALL_TIME 모드의 7200000 밀리 세컨드로 지정됩니다. 이 경우, end-rule 의 월 시계 시간은 서머타임과 같은 것이 됩니다.
다음은 타임 존 오브젝트를 구축하는 파라미터의 예입니다.
// Base GMT offset: -8:00
// DST starts: at 2:00am in standard time
// on the first Sunday in April
// DST ends: at 2:00am in daylight time
// on the last Sunday in October
// Save: 1 hour
SimpleTimeZone(-28800000,
"America/Los_Angeles",
Calendar.APRIL, 1, -Calendar.SUNDAY,
7200000,
Calendar.OCTOBER, -1, Calendar.SUNDAY,
7200000,
3600000)
// Base GMT offset: +1:00
// DST starts: at 1:00am in UTC time
// on the last Sunday in March
// DST ends: at 1:00am in UTC time
// on the last Sunday in October
// Save: 1 hour
SimpleTimeZone(3600000,
"Europe/Paris",
Calendar.MARCH, -1, Calendar.SUNDAY,
3600000, SimpleTimeZone.UTC_TIME,
Calendar.OCTOBER, -1, Calendar.SUNDAY,
3600000, SimpleTimeZone.UTC_TIME,
3600000)
setStartRule 등의, 규정의 규칙 메소드에도 적용됩니다.
Calendar ,
GregorianCalendar ,
TimeZone ,
직렬화 된 형식 | 필드의 개요 | |
static int |
STANDARD_TIME
표준시간으로서 지정된, 개시 시간 또는 종료시간의 모드 정수. |
static int |
UTC_TIME
UTC 로서 지정된 개시 시간 또는 종료시간의 모드의 정수. |
static int |
WALL_TIME
월 시계 시간으로서 지정한 개시 시간 또는 종료시간의 모드의 정수. |
| 클래스 java.util. TimeZone 에서 상속받은 필드 |
LONG , SHORT |
| 생성자의 개요 | |
SimpleTimeZone (int rawOffset,
String ID)
서머타임을 포함하지 않고 , GMT 로부터의 지정된 베이스 타임 존 오프셋(offset)과 타임 존 ID 에 의해, SimpleTimeZone 를 구축합니다. |
|
SimpleTimeZone (int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
GMT로부터의 지정된 베이스 타임 존 오프셋(offset), 타임 존 ID , 및 서머타임의 개시 규칙과 종료 규칙으로, SimpleTimeZone 를 구축합니다. |
|
SimpleTimeZone (int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int dstSavings)
GMT로부터의 지정된 베이스 타임 존 오프셋(offset), 타임 존 ID , 및 서머타임의 개시 규칙 및 종료 규칙에 의해, SimpleTimeZone 를 구축합니다. |
|
SimpleTimeZone (int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int startTimeMode,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int endTimeMode,
int dstSavings)
GMT로부터의 지정된 베이스 타임 존 오프셋(offset), 타임 존 ID , 및 서머타임의 개시 규칙 및 종료 규칙에 의해, SimpleTimeZone 를 구축합니다. |
|
| 메소드의 개요 | |
Object |
clone ()
이 SimpleTimeZone 의 인스턴스의 복제를 돌려줍니다. |
boolean |
equals (Object obj)
2 개의 SimpleTimeZone 오브젝트가 같은지 어떤지를 비교합니다. |
int |
getDSTSavings ()
서머타임에 시계를 진행시키는 시간량을 밀리 세컨드 단위로 돌려줍니다. |
int |
getOffset (int era,
int year,
int month,
int day,
int dayOfWeek,
int millis)
지정한 일자 및 시간에 대해, 직접 계산한 오프셋(offset) 및 서머타임의 영향을 고려해, 로컬 시간과 UTC 의 차이를 밀리 세컨드 단위로 돌려줍니다. |
int |
getOffset (long date)
지정된 시간에 UTC 로부터의 이 타임 존의 오프셋(offset)를 돌려줍니다. |
int |
getRawOffset ()
이 타임 존의 GMT 오프셋(offset)를 취득합니다. |
int |
hashCode ()
SimpleDateFormat 오브젝트의 해시 코드를 생성합니다. |
boolean |
hasSameRules (TimeZone other)
이 존이 비교된 다른 존과 같은 규칙과 오프셋(offset)를 가지는 경우에 true 를 돌려줍니다. |
boolean |
inDaylightTime (Date date)
지정된 일자가 서머타임의 기간내인가 어떤가를 문의합니다. |
void |
setDSTSavings (int millisSavedDuringDST)
서머타임의 기간에 시계를 진행시키는 시간량을 밀리 세컨드 단위로 설정합니다. |
void |
setEndRule (int endMonth,
int endDay,
int endTime)
서머타임의 종료 규칙을 월내의 고정일로 설정합니다. |
void |
setEndRule (int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
서머타임의 종료 규칙을 설정합니다. |
void |
setEndRule (int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
boolean after)
8 일 또는 그 이후의 최초의 월요일과 같이, 서머타임의 종료 규칙을 월내의 지정일의 전후의 평일로 설정합니다. |
void |
setRawOffset (int offsetMillis)
GMT 에의 베이스 타임 존 오프셋(offset)를 설정합니다. |
void |
setStartRule (int startMonth,
int startDay,
int startTime)
서머타임의 개시 규칙을 월내의 고정일로 설정합니다. |
void |
setStartRule (int startMonth,
int startDay,
int startDayOfWeek,
int startTime)
서머타임의 개시 규칙을 설정합니다. |
void |
setStartRule (int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
boolean after)
8 일 또는 그 이후의 최초의 월요일과 같이, 서머타임의 개시 규칙을 월내의 지정일의 전후의 평일로 설정합니다. |
void |
setStartYear (int year)
서머타임이 개시된 해를 설정합니다. |
String |
toString ()
이 타임 존의 캐릭터 라인 표현을 돌려줍니다. |
boolean |
useDaylightTime ()
현재의 소재지의 타임 존이 서머타임을 사용하고 있을지 어떨지를 문의합니다. |
| 클래스 java.util. TimeZone 에서 상속받은 메소드 |
getAvailableIDs , getAvailableIDs , getDefault , getDisplayName , getDisplayName , getDisplayName , getDisplayName , getID , getTimeZone , setDefault , setID |
| 클래스 java.lang. Object 에서 상속받은 메소드 |
finalize , getClass , notify , notifyAll , wait , wait , wait |
| 필드의 상세 |
public static final int WALL_TIME
public static final int STANDARD_TIME
public static final int UTC_TIME
| 생성자의 상세 |
public SimpleTimeZone(int rawOffset,
String ID)
rawOffset - 밀리 세컨드 단위의 GMT 에의 베스트타임존오후셋트ID - 이 인스턴스로 지정된 타임 존명
public SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
startTime 및 endTime 가 월 시계 시간에 나타내지도록(듯이) 지정합니다. 서머타임의 양은 3600000 밀리 세컨드 (즉 1 시간)이라고 가정합니다. 이 constructor 은 다음과 같습니다.
SimpleTimeZone(rawOffset,
ID,
startMonth,
startDay,
startDayOfWeek,
startTime,
SimpleTimeZone. WALL_TIME ,
endMonth,
endDay,
endDayOfWeek,
endTime,
SimpleTimeZone. WALL_TIME ,
3600000)
rawOffset - GMT 로부터의 지정된 베이스 타임 존 오프셋(offset)ID - 이 오브젝트로 지정된 타임 존 IDstartMonth - 서머타임이 시작되는 달. 달은 MONTH 의 필드치 (0으로부터 시작된다. 즉, 1월은 0)startDay - 서머타임이 개시하는 달의 일자. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조startDayOfWeek - 서머타임이 개시하는 요일. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조startTime - 일자의 밀리 세컨드 단위의, 로컬의 월 시계 시간에서의 서머타임의 개시 시간. 이 경우는 로컬의 표준시간endMonth - 서머타임의 종료월. 달은 MONTH 의 필드치 (0 으로부터 시작된다. 즉, 10월은 9)endDay - 서머타임이 종료하는 달의 일자. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조endDayOfWeek - 서머타임이 종료하는 요일. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조endTime - 일자의 밀리 세컨드 단위의, 로컬의 월 시계 시간에서의 서머타임의 종료시간. 이 경우는 로컬의 서머타임
IllegalArgumentException - month, day, dayOfWeek, 또는 time 파라미터가 개시 규칙 또는 종료 규칙의 범위외의 경우
public SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int dstSavings)
startTime 및 endTime 의 양쪽 모두가 월 시계 시간에 나타내지면(자) 가정됩니다. 이 constructor 은 다음과 같습니다.
SimpleTimeZone(rawOffset,
ID,
startMonth,
startDay,
startDayOfWeek,
startTime,
SimpleTimeZone. WALL_TIME ,
endMonth,
endDay,
endDayOfWeek,
endTime,
SimpleTimeZone. WALL_TIME ,
dstSavings)
rawOffset - GMT 로부터의 지정된 베이스 타임 존 오프셋(offset)ID - 이 오브젝트로 지정된 타임 존 IDstartMonth - 서머타임이 시작되는 달. 달은 MONTH 의 필드치 (0으로부터 시작된다. 즉, 1월은 0)startDay - 서머타임이 개시하는 달의 일자. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조startDayOfWeek - 서머타임이 개시하는 요일. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조startTime - 로컬의 월 시계 시간의 서머타임의 개시 시간. 이 경우는 로컬의 표준시간endMonth - 서머타임의 종료월. 달은 MONTH 의 필드치 (0 으로부터 시작된다. 즉, 10월은 9)endDay - 서머타임이 종료하는 달의 일자. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조endDayOfWeek - 서머타임이 종료하는 요일. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조endTime - 로컬의 월 시계 시간의 서머타임의 종료시간. 이 경우는 로컬의 서머타임dstSavings - 서머타임의 기간에 앞당길 수 있는 밀리 세컨드 단위의 시간량.
IllegalArgumentException - month, day, dayOfWeek, 또는 time 파라미터가 개시 규칙 또는 종료 규칙의 범위외의 경우
public SimpleTimeZone(int rawOffset,
String ID,
int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
int startTimeMode,
int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
int endTimeMode,
int dstSavings)
startTime 및 endTime 의 모드 등, 풀 세트의 개시 규칙과 종료 규칙의 파라미터를 취득합니다. 모드는 wall time ,standard time , 또는 UTC time 의 어느쪽이든을 지정합니다.
rawOffset - GMT 로부터의 지정된 베이스 타임 존 오프셋(offset)ID - 이 오브젝트로 지정된 타임 존 IDstartMonth - 서머타임이 시작되는 달. 달은 MONTH 의 필드치 (0으로부터 시작된다. 즉, 1월은 0)startDay - 서머타임이 개시하는 달의 일자. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조startDayOfWeek - 서머타임이 개시하는 요일. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조startTime - startTimeMode 에 의해 지정된 시간 모드에서의 서머타임의 개시 시간startTimeMode - startTime 에 의해 지정된 개시 시간의 모드endMonth - 서머타임의 종료월. 달은 MONTH 의 필드치 (0 으로부터 시작된다. 즉, 10월은 9)endDay - 서머타임이 종료하는 달의 일자. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조endDayOfWeek - 서머타임이 종료하는 요일. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조endTime - endTimeMode 에 의해 지정된 시간 모드에서의 서머타임의 종료시간endTimeMode - endTime에 의해 지정된 종료시간의 모드dstSavings - 서머타임의 기간에 앞당길 수 있는 밀리 세컨드 단위의 시간량.
IllegalArgumentException - month, day, dayOfWeek, time more, 또는 time 파라미터가 개시 규칙 또는 종료 규칙의 범위외의 경우. 또는 타임 모드치가 무효의 경우WALL_TIME ,
STANDARD_TIME ,
UTC_TIME | 메소드의 상세 |
public void setStartYear(int year)
year - 서머타임이 개시된 해
public void setStartRule(int startMonth,
int startDay,
int startDayOfWeek,
int startTime)
setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);
startMonth - 서머타임이 시작되는 달. 달은 MONTH 의 필드치 (0으로부터 시작된다. 즉, 1월은 0)startDay - 서머타임이 개시하는 달의 일자. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조startDayOfWeek - 서머타임이 개시하는 요일. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조startTime - 로컬의 월 시계 시간의 서머타임의 개시 시간. 이 경우는 로컬의 표준시간
IllegalArgumentException - startMonth,startDay,startDayOfWeek, 또는 startTime 파라미터가 범위외의 경우
public void setStartRule(int startMonth,
int startDay,
int startTime)
setStartRule(startMonth, startDay, 0, startTime)
startMonth - 서머타임이 시작되는 달. 달은 MONTH 의 필드치 (0으로부터 시작된다. 즉, 1월은 0)startDay - 서머타임이 개시하는 달의 일자startTime - 로컬의 월 클락 타임의 서머타임의 개시 시간. 이 경우는 로컬의 표준시간. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조
IllegalArgumentException - startMonth,startDayOfMonth, 또는 startTime 파라미터가 범위외의 경우
public void setStartRule(int startMonth,
int startDay,
int startDayOfWeek,
int startTime,
boolean after)
startMonth - 서머타임이 시작되는 달. 달은 MONTH 의 필드치 (0으로부터 시작된다. 즉, 1월은 0)startDay - 서머타임이 개시하는 달의 일자startDayOfWeek - 서머타임이 개시하는 요일startTime - 로컬의 월 시계 시간의 서머타임의 개시 시간. 이 경우는 로컬의 표준시간after - true 의 경우, 이 규칙은 dayOfMonth 또는 그 이후의 최초의 dayOfWeek 를 선택한다. false 의 경우, 이 규칙은 dayOfMonth 또는 그 이전의 마지막 dayOfWeek 를 선택한다
IllegalArgumentException - startMonth,startDay,startDayOfWeek, 또는 startTime 파라미터가 범위외의 경우
public void setEndRule(int endMonth,
int endDay,
int endDayOfWeek,
int endTime)
setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2*60*60*1000);
endMonth - 서머타임의 종료월. 달은 MONTH 의 필드치 (0 으로부터 시작된다. 즉, 10월은 9)endDay - 서머타임이 종료하는 달의 일자. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조endDayOfWeek - 서머타임이 종료하는 요일. 이 파라미터의 특례에 대해서는 클래스의 설명을 참조endTime - 일자의 밀리 세컨드 단위의, 로컬의 월 시계 시간에서의 서머타임의 종료시간. 이 경우는 로컬의 서머타임
IllegalArgumentException - endMonth,endDay,endDayOfWeek 또는 endTime 파라미터가 범위외의 경우
public void setEndRule(int endMonth,
int endDay,
int endTime)
setEndRule(endMonth, endDay, 0, endTime)
endMonth - 서머타임의 종료월. 달은 MONTH 의 필드치 (0 으로부터 시작된다. 즉, 10월은 9)endDay - 서머타임이 종료하는 달의 일자endTime - 일자의 밀리 세컨드 단위의, 로컬의 월 시계 시간에서의 서머타임의 종료시간. 이 경우는 로컬의 서머타임
IllegalArgumentException - endMonth,endDay,endDayOfWeek 또는 endTime 파라미터가 범위외의 경우
public void setEndRule(int endMonth,
int endDay,
int endDayOfWeek,
int endTime,
boolean after)
endMonth - 서머타임의 종료월. 달은 MONTH 의 필드치 (0 으로부터 시작된다. 즉, 10월은 9)endDay - 서머타임이 종료하는 달의 일자endDayOfWeek - 서머타임이 종료하는 요일endTime - 일자의 밀리 세컨드 단위의, 로컬의 월 시계 시간에서의 서머타임의 종료시간. 이 경우는 로컬의 서머타임after - true의 경우, 이 규칙은 endDay 또는 그 이후의 최초의 endDayOfWeek 를 선택한다. false 의 경우, 이 규칙은 달의 endDay 또는 그 이전의 endDayOfWeek 를 선택한다
IllegalArgumentException - endMonth,endDay,endDayOfWeek 또는 endTime 파라미터가 범위외의 경우public int getOffset(long date)
TimeZone 내의 getOffset date - 타임 존 오프셋(offset)가 발견된 시간
Calendar.ZONE_OFFSET ,
Calendar.DST_OFFSET
public int getOffset(int era,
int year,
int month,
int day,
int dayOfWeek,
int millis)
GregorianCalendar 오브젝트가 사용됩니다. 디폴트의 GregorianCalendar 이외의 달력으로, 이 메소드의 결과를 사용하지 말아 주세요.
주: 통상, 클라이언트는 이 메소드를 호출하는 것이 아니라,Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET) 를 사용합니다.
TimeZone 내의 getOffset era - 지정하는 일자의 연호year - 지정하는 일자의 해month - 지정하는 일자의 달. 달은 0 으로부터 시작된다. 예를 들어, 1 월은 0day - 지정하는 일자의 날dayOfWeek - 지정하는 일자의 요일millis - 표준로컬 타임에서의, 지정된 날의 밀리 세컨드
IllegalArgumentException - era,month,day,dayOfWeek 또는 millis 파라미터가 범위외의 경우Calendar.ZONE_OFFSET ,
Calendar.DST_OFFSET public int getRawOffset()
TimeZone 내의 getRawOffset setRawOffset(int) public void setRawOffset(int offsetMillis)
TimeZone 내의 setRawOffset offsetMillis - 지정된 GMT 에의 베이스 타임 존 오프셋(offset)getRawOffset() public void setDSTSavings(int millisSavedDuringDST)
millisSavedDuringDST - 서머타임 규칙이 시작될 때 표준시부터 진행하는 밀리 세컨드 단위의 시간량. 정의 수치로, 통상은 1 시간 (3600000)getDSTSavings() public int getDSTSavings()
TimeZone 내의 getDSTSavings setDSTSavings(int) public boolean useDaylightTime()
TimeZone 내의 useDaylightTime public boolean inDaylightTime(Date date)
TimeZone 내의 inDaylightTime date - 지정된 Date
public Object clone()
SimpleTimeZone 의 인스턴스의 복제를 돌려줍니다.
TimeZone 내의 clone public int hashCode()
Object 내의 hashCode Object.equals(java.lang.Object) ,
Hashtable public boolean equals(Object obj)
SimpleTimeZone 오브젝트가 같은지 어떤지를 비교합니다.
Object 내의 equals obj - 비교되는 SimpleTimeZone 오브젝트
SimpleTimeZone오브젝트와 같은 경우는 true, 그렇지 않은 경우는 falseObject.hashCode() ,
Hashtable public boolean hasSameRules(TimeZone other)
TimeZone 내의 hasSameRules other - 비교되는 TimeZone 오브젝트
public String toString()
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.