|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
java.lang.Objectjava.util.TimeZone
java.util.SimpleTimeZone
public class 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
등, Calendar 의 MONTH
필드치에 의해 나타내집니다. day-of-week 치는,SUNDAY
등, Calendar 의 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
입니다. 예를 들어, 서머타임이, 월 (벽) 시계 시간의 오전 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 시간)이라고 가정합니다. 이 생성자 은 다음과 같습니다.
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
- 로컬 월 시계 시간에서의 서머타임의 개시시각 (1 히나이의 밀리 세컨드). 이 경우, 이것은 로컬 표준시간이 되는endMonth
- 서머타임이 끝나는 달. 달은 MONTH
의 필드치 (0으로부터 시작된다. 즉, 10 월은 9)endDay
- 서머타임이 종료하는 달의 일자
이 파라미터의 특례에 대해서는, 클래스의 설명을 참조endDayOfWeek
- 서머타임이 종료하는 요일
이 파라미터의 특례에 대해서는, 클래스의 설명을 참조endTime
- 로컬 월 시계 시간에서의 서머타임의 종료시각 (1 히나이의 밀리 세컨드). 이 경우, 이것은 로컬 서머타임이 된다
IllegalArgumentException
- 개시 규칙 또는 종료 규칙의 월, 날, 요일, 시각의 몇개의 파라미터가 범위외의 경우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
의 양쪽 모두가 월 시계 시간에 나타내지면(자) 가정됩니다. 이 생성자 은 다음과 같습니다.
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
- 개시 규칙 또는 종료 규칙의 월, 날, 요일, 시각의 몇개의 파라미터가 범위외의 경우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
- 개시 규칙 또는 종료 규칙의 월, 날, 요일, 시각 모드, 시각의 몇개의 파라미터가 범위외의 경우, 또는 시각 모드의 값이 무효인 경우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
- 로컬 월 시계 시간에서의 서머타임의 종료시각 (1 히나이의 밀리 세컨드). 이 경우, 이것은 로컬 서머타임이 된다
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
- 로컬 월 시계 시간에서의 서머타임의 종료시각 (1 히나이의 밀리 세컨드). 이 경우, 이것은 로컬 서머타임이 된다
IllegalArgumentException
- endMonth
,endDay
, 또는 endTime
파라미터가 범위외의 경우public void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime, boolean after)
endMonth
- 서머타임이 끝나는 달. 달은 MONTH
의 필드치 (0으로부터 시작된다. 즉, 10 월은 9)endDay
- 서머타임이 종료하는 달의 일자endDayOfWeek
- 서머타임이 종료하는 요일endTime
- 로컬 월 시계 시간에서의 서머타임의 종료시각 (1 히나이의 밀리 세컨드). 이 경우, 이것은 로컬 서머타임이 되는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 으로부터 시작된다. 0 이 1 월day
- 지정하는 일자의 날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
Cloneable
public int hashCode()
Object
내의 hashCode
Object.equals(java.lang.Object)
,
Hashtable
public boolean equals(Object obj)
SimpleTimeZone
객체가 같은지 어떤지를 비교합니다.
Object
내의 equals
obj
- 비교되는 SimpleTimeZone
객체
obj
가 이 SimpleTimeZone
객체와 같은 경우는 true, 그 이외의 경우는 falseObject.hashCode()
,
Hashtable
public boolean hasSameRules(TimeZone other)
true
를 돌려줍니다.
TimeZone
내의 hasSameRules
other
- 비교되는 TimeZone 객체
true
public String toString()
Object
내의 toString
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.