java.util
클래스 TimeZone

java.lang.Object 
  |
  +--java.util.TimeZone

모든 구현 인터페이스:

Cloneable , Serializable

직계의 기존의 서브 클래스:

SimpleTimeZone

public abstract class TimeZone

extends Object

implements Serializable , Cloneable

TimeZone 는 타임 존 오프셋(offset)를 나타냅니다. 또, 서머타임을 인식합니다.

통상은 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 부호 시 : 분
         GMT 부호 시 분
         GMT 부호 시
 부호: 다음의 어느 쪽인지
         + -
 시:
         숫자
         숫자 숫자
 분:
         숫자 숫자
 숫자: 다음의 어느쪽이든 1 kr
         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 부호 TwoDigitHours : 분
 부호: 다음의 어느 쪽인지
         + -
 TwoDigitHours:
         숫자 숫자
 분:
         숫자 숫자
 숫자: 다음의 어느쪽이든 1 kr
         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 kr 밖에 인식되지 않기 때문에, 이 사용은 추천 되지 않습니다.

도입된 버젼:

JDK1. 1

관련 항목:

Calendar , GregorianCalendar , SimpleTimeZone , 직렬화 된 형식

필드의 개요

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

생성자의 개요

TimeZone ()
유일한 constructor 입니다.

메소드의 개요

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()

유일한 constructor 입니다. 서브 클래스의 constructor 에 의한 호출은 통상은 암묵적인 호출입니다.

메소드의 상세

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)로서 설정되어 소정의 최신 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 구현 서브 클래스가, 서머타임의 역사적 변화를 서포트하는 경우, 이 메소드는 소정의 최신 서머타임치를 돌려줍니다.

반환값:

밀리 세컨드 단위의 서머타임의 양

도입된 버젼:

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 를 가지지만, 서머타임의 동작에는 차이가 있다

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