TimeZone (Java Platform SE 6) - xrath.com 에서 번역됨

일반적으로은,getDefault 를 사용해 TimeZone 를 가져옵니다. 이 메소드는, 프로그램을 실행하고 있는 장소의 타임 존에 근거한 TimeZone 를 작성합니다. 예를 들어, 일본에서 실행되고 있는 프로그램의 경우,getDefault 는 일본 표준시를 기본으로 TimeZone 객체를 작성합니다.

타임 존 ID 를 지정해 getTimeZone 를 사용해 TimeZone 를 취득할 수도 있습니다. 예를 들어, 태평양 표준시의 타임 존 ID 는, 「America/Los_Angeles」입니다. 따라서, 다음과 같이 입력해 PST TimeZone 객체를 취득할 수 있습니다.

 TimeZone tz = TimeZone.getTimeZone("America/Los_Angeles");

getAvailableIDs 메소드를 사용해, 지원 떠날 수 있어 모든 타임 존 ID 를 조사할 수가 있습니다. 지원되고 있는 ID 중에서, 목적의 TimeZone 를 선택할 수 있습니다. 지원되고 있는 ID 의 어느 쪽인가에 따라 필요한 타임 존이 나타내지지 않은 경우는, 커스텀 타임 존 ID 를 지정해, TimeZone 를 생성할 수가 있습니다. 커스텀 타임 존 ID 의 구문은 다음과 같습니다.

 CustomID: 
         GMT Sign Hours : Minutes
         GMT Sign Hours Minutes
         GMT Sign Hours
 Sign: one of
         + -
 Hours:
         Digit
         Digit Digit
 Minutes:
         Digit Digit
 Digit: one of
         0 1 2 3 4 5 6 7 8 9

Hours 는 0 ~ 23 으로,Minutes 는 00 ~ 59 를 지정할 필요가 있습니다. 예를 들어, 「GMT+10」(와)과「GMT+0010」은, 각각, GMT 의 10 시간전과 10 분전이 됩니다.

형식은 로케일에 의존하지 않습니다. 숫자는 Unicode 표준의 Basic Latin 블록으로부터 취득할 필요가 있습니다. 서머타임에의 이행 스케줄은, 커스텀 타임 존 ID 로 지정할 수 없습니다. 지정된 캐릭터 라인이 구문과 일치하지 않는 경우는, 「GMT」를 사용합니다.

TimeZone 를 작성할 때는, 지정된 커스텀 타임 존 ID 는, 다음의 구문으로 규정됩니다.

 NormalizedCustomID: 
         GMT Sign TwoDigitHours : Minutes
 Sign: one of
         + -
 TwoDigitHours:
         Digit Digit
 Minutes:
         Digit Digit
 Digit: one of
         0 1 2 3 4 5 6 7 8 9

예를 들어, TimeZone.getTimeZone("GMT-8"). getID()는 GMT-08:00 를 돌려줍니다.

3 문자의 타임 존 ID

JDK 1.1.x 와의 호환성을 위해서(때문에), 그 외의 3 문자의 타임 존 ID ( 「PST」, 「CTT」, 「AST」등)도 지원되고 있습니다. 다만, 복수의 타임 존에 같은 생략형이 사용되는 것이 많아 ( 「CST」는 미국의 「중앙 표준시」와「중국 표준시」 등), Java 플랫폼에서는 그 1 개(살) 밖에 인식되지 않기 때문에, 이 사용은 추천 되지 않습니다.

도입된 버젼:: JDK1. 1
관련 항목:: Calendar , GregorianCalendar , SimpleTimeZone , 직렬화 된 형식

필드의 개요
`static int`	`LONG` 「Pacific Standard Time」등이 긴 이름을 나타내는 `getDisplayName()` 의 스타일 지시자입니다.
`static int`	`SHORT` 「PST」등이 짧은 이름을 나타내는 `getDisplayName()` 의 스타일 지시자입니다.

생성자 의 개요
`TimeZone ()` 유일한 생성자 입니다.

메소드의 개요
`Object`	`clone ()` 이 `TimeZone` 의 카피를 작성합니다.
`static String []`	`getAvailableIDs ()` 지원되는 이용 가능한 ID 를 모두 가져옵니다.
`static String []`	`getAvailableIDs (int rawOffset)` 밀리 세컨드 단위로 지정된 타임 존 오프셋(offset)와 일치하는 ID 로 사용 가능한 것을 가져옵니다.
`static TimeZone`	`getDefault ()` 이 호스트의 디폴트의 `TimeZone` 를 가져옵니다.
`String`	`getDisplayName ()` 디폴트 로케일에서의 현재의 타임 존의 이름을, 사용자에게로의 표시에 적절한 형식에서 돌려줍니다.
`String`	`getDisplayName (boolean daylight, int style)` 디폴트 로케일에서의 현재의 타임 존의 이름을, 사용자에게로의 표시에 적절한 형식에서 돌려줍니다.
`String`	`getDisplayName (boolean daylight, int style, Locale locale)` 지정된 로케일에서의 현재의 타임 존의 이름을, 사용자에게로의 표시에 적절한 형식에서 돌려줍니다.
`String`	`getDisplayName (Locale locale)` 지정된 로케일에서의 현재의 타임 존의 이름을, 사용자에게로의 표시에 적절한 형식에서 돌려줍니다.
`int`	`getDSTSavings ()` 로컬 월 시계 시간을 취득하기 위해서, 로컬의 표준시간에 추가하는 시간의 양을 돌려줍니다.
`String`	`getID ()` 현재의 소재지의 타임 존의 ID 를 가져옵니다.
`abstract int`	`getOffset (int era, int year, int month, int day, int dayOfWeek, int milliseconds)` 현재의 일자의 타임 존 오프셋(offset)를 돌려줍니다.
`int`	`getOffset (long date)` 지정된 일자로 UTC 로부터의 이 타임 존의 오프셋(offset)를 돌려줍니다.
`abstract int`	`getRawOffset ()` 이 타임 존의 표준시간을 취득하기 위해서, UTC 에 추가하는 밀리 세컨드 단위의 시간량을 돌려줍니다.
`static TimeZone`	`getTimeZone (String ID)` 지정된 ID 의 `TimeZone` 를 가져옵니다.
`boolean`	`hasSameRules (TimeZone other)` 이 존이 비교되는 다른 존과 같은 규칙과 오프셋(offset)를 가지는 경우에 true 를 돌려줍니다.
`abstract boolean`	`inDaylightTime (Date date)` 지정된 일자가, 현재의 소재지의 타임 존에서는 서머타임의 기간내인가 어떤가를 문의합니다.
`static void`	`setDefault (TimeZone zone)` `getDefault` 메소드로 반환되는 `TimeZone` 를 설정합니다.
`void`	`setID (String ID)` 타임 존 ID 를 설정합니다.
`abstract void`	`setRawOffset (int offsetMillis)` GMT 에의 베이스 타임 존 오프셋(offset)를 설정합니다.
`abstract boolean`	`useDaylightTime ()` 현재의 소재지의 타임 존이 서머타임을 사용하고 있을지 어떨지를 문의합니다.

클래스 java.lang. Object 로부터 상속된 메소드
`equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

필드의 상세

SHORT

public static final int SHORT

「PST」등이 짧은 이름을 나타내는 getDisplayName() 의 스타일 지시자입니다.

도입된 버젼:: 1.2
관련 항목:: LONG , 정수 필드치

LONG

public static final int LONG

「Pacific Standard Time」등이 긴 이름을 나타내는 getDisplayName() 의 스타일 지시자입니다.

도입된 버젼:: 1.2
관련 항목:: SHORT , 정수 필드치

생성자 의 상세

TimeZone

public TimeZone()

유일한 생성자 입니다. 서브 클래스의 생성자 에 의한 호출용으로, 일반적으로은 암묵적으로 불려 갑니다.

메소드의 상세

getOffset

public abstract int getOffset(int era,
                              int year,
                              int month,
                              int day,
                              int dayOfWeek,
                              int milliseconds)

현재의 일자의 타임 존 오프셋(offset)를 돌려줍니다. 서머타임의 기간내이면 수정되고 있습니다. 이것은, 로컬 타임을 취득하기 위해서 UTC 에 추가하는 오프셋(offset)입니다.

기본이 되는 TimeZone 구현 서브 클래스가, 서머타임과 GMT 오프셋(offset)의 역사적 변화를 지원하는 경우, 이 메소드는 역사적으로 적절한 오프셋(offset)를 돌려줍니다.

파라미터:: era - 지정하는 일자의 연호; year - 지정하는 일자의 해; month - 지정하는 일자의 달. 달은 0 으로부터 시작된다. 0 이 1 월; day - 지정하는 일자의 날; dayOfWeek - 지정하는 일자의 요일; milliseconds - 표준로컬 타임에서의, 지정된 날의 밀리 세컨드
반환값:: 로컬 타임을 취득하기 위해서 GMT 에 추가하는 밀리 세컨드 단위의 오프셋(offset)
관련 항목:: Calendar.ZONE_OFFSET , Calendar.DST_OFFSET

getOffset

public int getOffset(long date)

지정된 일자로 UTC 로부터의 이 타임 존의 오프셋(offset)를 돌려줍니다. 서머타임이 지정된 일자로 실시되고 있는 경우, 오프셋(offset)치는 서머타임의 양으로 조절됩니다.

기본이 되는 TimeZone 구현 서브 클래스가, 서머타임과 GMT 오프셋(offset)의 역사적 변화를 지원하는 경우, 이 메소드는 역사적으로 적절한 오프셋(offset)치를 돌려줍니다.

파라미터:: date - 1970 년 1 월 1 일 00:00:00 GMT 로부터의, 밀리 세컨드 단위로 나타내진 일자
반환값:: 로컬 타임을 취득하기 위해서 UTC 에 추가하는 밀리 세컨드 단위의 시간의 양
도입된 버젼:: 1.4
관련 항목:: Calendar.ZONE_OFFSET , Calendar.DST_OFFSET

setRawOffset

public abstract void setRawOffset(int offsetMillis)

GMT 에의 베이스 타임 존 오프셋(offset)를 설정합니다. 이것은, 로컬 타임을 취득하기 위해서 UTC 에 추가하는 오프셋(offset)입니다.

기반이 되는 TimeZone 구현 서브 클래스가, GMT 오프셋(offset)의 역사적 변화를 지원하는 경우, 지정된 GMT 오프셋(offset)는 최신의 GMT 오프셋(offset)로서 설정되어 주어진(given) 최신 GMT 오프셋(offset)치와의 차이를 사용해, 역사상의 모든 GMT 오프셋(offset)치를 조정합니다.

파라미터:: offsetMillis - 지정된 GMT 에의 베이스 타임 존 오프셋(offset)

getRawOffset

public abstract int getRawOffset()

이 타임 존의 표준시간을 취득하기 위해서, UTC 에 추가하는 밀리 세컨드 단위의 시간량을 돌려줍니다. 이 값은 서머타임에 의해 영향을 받지 않기 때문에, 「직접 계산한 오프셋(offset)」라고 불립니다.

기본이 되는 TimeZone 구현 서브 클래스가 GMT 오프셋(offset)의 역사적 변화를 지원하는 경우, 메소드는 현재의 일자의 직접 계산된 오프셋(offset)치를 돌려줍니다. 예를 들어 호놀루루에서는, 1947 년에 직접 계산된 오프셋(offset)가 GMT-10:30 로부터 GMT-10:00 로 변경했으므로, 이 메소드는 항상 -36000000 밀리 세컨드 (즉 -10 시간)를 돌려줍니다.

반환값:: UTC 에 추가되는, 밀리 세컨드 단위의 직접 계산된 오프셋(offset) 시간의 양
관련 항목:: Calendar.ZONE_OFFSET

getID

public String  getID()

현재의 소재지의 타임 존의 ID 를 가져옵니다.

반환값:: 현재의 소재지의 타임 존의 ID

setID

public void setID(String  ID)

타임 존 ID 를 설정합니다. 타임 존 객체내외의 데이터는 변경되지 않습니다.

파라미터:: ID - 새로운 타임 존 ID

getDisplayName

public final String  getDisplayName()

디폴트 로케일에서의 현재의 타임 존의 이름을, 사용자에게로의 표시에 적절한 형식에서 돌려줍니다. 이 메소드는, 긴 이름을 돌려줍니다. 서머타임은 포함되지 않습니다. 로케일의 표시명이 없는 경우, 이 메소드는규정화된 커스텀 ID 형식에서 캐릭터 라인을 돌려줍니다.

반환값:: 디폴트 로케일에서의 현재의 타임 존을, 사람이 이해할 수 있는 형식으로 한 이름
도입된 버젼:: 1.2

getDisplayName

public final String  getDisplayName(Locale  locale)

지정된 로케일에서의 현재의 타임 존의 이름을, 사용자에게로의 표시에 적절한 형식에서 돌려줍니다. 이 메소드는, 긴 이름을 돌려줍니다. 서머타임은 포함되지 않습니다. 로케일의 표시명이 없는 경우, 이 메소드는규정화된 커스텀 ID 형식에서 캐릭터 라인을 돌려줍니다.

파라미터:: locale - 표시명을 제공하는 로케일
반환값:: 지정된 로케일에서의 현재의 타임 존을, 사람이 이해할 수 있는 형식으로 한 이름
도입된 버젼:: 1.2

getDisplayName

public final String  getDisplayName(boolean daylight,
                                   int style)

디폴트 로케일에서의 현재의 타임 존의 이름을, 사용자에게로의 표시에 적절한 형식에서 돌려줍니다. 로케일의 표시명이 없는 경우, 이 메소드는규정화된 커스텀 ID 형식에서 캐릭터 라인을 돌려줍니다.

파라미터:: daylight - true 의 경우, 서머타임의 이름을 돌려주는; style - LONG 또는 SHORT 의 어느 쪽인지
반환값:: 디폴트 로케일에서의 현재의 타임 존을, 사람이 이해할 수 있는 형식으로 한 이름
도입된 버젼:: 1.2

getDisplayName

public String  getDisplayName(boolean daylight,
                             int style,
                             Locale  locale)

지정된 로케일에서의 현재의 타임 존의 이름을, 사용자에게로의 표시에 적절한 형식에서 돌려줍니다. 로케일의 표시명이 없는 경우, 이 메소드는규정화된 커스텀 ID 형식에서 캐릭터 라인을 돌려줍니다.

파라미터:: daylight - true 의 경우, 서머타임의 이름을 돌려주는; style - LONG 또는 SHORT 의 어느 쪽인지; locale - 표시명을 제공하는 로케일
반환값:: 지정된 로케일에서의 현재의 타임 존을, 사람이 이해할 수 있는 형식으로 한 이름
예외:: IllegalArgumentException - 스타일이 무효인 경우
도입된 버젼:: 1.2

getDSTSavings

public int getDSTSavings()

로컬 월 시계 시간을 취득하기 위해서, 로컬의 표준시간에 추가하는 시간의 양을 돌려줍니다.

이 타임 존이 서머타임에 따르는 경우, 디폴트의 구현은 항상 3600000 초 (즉 1 시간)를 돌려줍니다. 따르지 않는 경우는, 0 을 돌려줍니다.

기본이 되는 TimeZone 구현 서브 클래스가, 서머타임의 역사적 변화를 지원하는 경우, 이 메소드는 주어진(given) 최신 서머타임치를 돌려줍니다.

반환값:: 밀리 세컨드 단위의 서머타임의 양
도입된 버젼:: 1.4

useDaylightTime

public abstract boolean useDaylightTime()

현재의 소재지의 타임 존이 서머타임을 사용하고 있을지 어떨지를 문의합니다.

기본이 되는 TimeZone 구현 서브 클래스가, 서머타임의 스케줄의 역사적 변화를 지원하는 경우, 이 메소드는 최신의 서머타임 정보를 참조합니다.

반환값:: 현재의 소재지의 타임 존이 서머타임을 사용하고 있는 경우는 true, 그 이외의 경우는 false

inDaylightTime

public abstract boolean inDaylightTime(Date  date)

지정된 일자가, 현재의 소재지의 타임 존에서는 서머타임의 기간내인가 어떤가를 문의합니다.

파라미터:: date - 지정된 Date
반환값:: 지정된 일자가 서머타임의 기간내인 경우는 true, 그 이외의 경우는 false

getTimeZone

public static TimeZone  getTimeZone(String  ID)

지정된 ID 의 TimeZone 를 가져옵니다.

파라미터:: ID - TimeZone 의 ID. 「PST」와 같은 단축 형식, 「America/Los_Angeles」와 같이 완전한 이름, 혹은 「GMT-8:00」과 같은 커스텀 ID 의 어떤 것인가. 단축 형식은, JDK 1.1.x 와의 호환성 (을) 위해서만 지원되고 있기 (위해)때문에, 완전한 이름을 사용할 필요가 있다
반환값:: 지정된 TimeZone. 지정된 ID 를 인식할 수 없는 경우는 GMT 존

getAvailableIDs

public static String [] getAvailableIDs(int rawOffset)

밀리 세컨드 단위로 지정된 타임 존 오프셋(offset)와 일치하는 ID 로 사용 가능한 것을 가져옵니다.

파라미터:: rawOffset - 밀리 세컨드 단위로 지정된 타임 존의 GMT 오프셋(offset)
반환값:: ID 의 배열. 배열내의 ID 의 타임 존은, 지정된 GMT 오프셋(offset)를 가진다. 예를 들어, 「America/Phoenix」와「America/Denver」는 어느쪽이나 GMT-07:00 를 가지지만, 서머타임의 동작에는 차이가 있는
관련 항목:: getRawOffset()

getAvailableIDs

public static String [] getAvailableIDs()

지원되는 이용 가능한 ID 를 모두 가져옵니다.

반환값:: ID 의 배열

getDefault

public static TimeZone  getDefault()

이 호스트의 디폴트의 TimeZone 를 가져옵니다. 디폴트의 TimeZone 의 소스는, 구현에 따라서 다릅니다.

반환값:: 디폴트의 TimeZone
관련 항목:: setDefault(java.util.TimeZone)

setDefault

public static void setDefault(TimeZone  zone)

getDefault 메소드로 반환되는 TimeZone 를 설정합니다. zone 가 null 의 경우, VM 가 최초로 개시되었을 때의 값에 디폴트가 리셋 됩니다.

파라미터:: zone - 새로운 디폴트의 타임 존
관련 항목:: getDefault()

hasSameRules

public boolean hasSameRules(TimeZone  other)

이 존이 비교되는 다른 존과 같은 규칙과 오프셋(offset)를 가지는 경우에 true 를 돌려줍니다. 즉, 이 존의 ID 만이 다른 경우에는 true 를 돌려줍니다. 다른 존이 null 의 경우는 false 를 돌려줍니다.

파라미터:: other - 비교되는 TimeZone 객체
반환값:: 다른 존이 null 로, 이 존과 ID 이외는 완전히 같은 경우는 true
도입된 버젼:: 1.2

clone

public Object  clone()

이 TimeZone 의 카피를 작성합니다.

오버라이드(override):: 클래스 Object 내의 clone

반환값:: 이 TimeZone 의 복제
관련 항목:: Cloneable

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

java.util 클래스 TimeZone

3 문자의 타임 존 ID

SHORT

LONG

TimeZone

getOffset

getOffset

setRawOffset

getRawOffset

getID

setID

getDisplayName

getDisplayName

getDisplayName

getDisplayName

getDSTSavings

useDaylightTime

inDaylightTime

getTimeZone

getAvailableIDs

getAvailableIDs

getDefault

setDefault

hasSameRules

clone

java.util
클래스 TimeZone