java.util
클래스 TimeZone

java.lang.Object 
  java.util.TimeZone

모든 구현된 인터페이스:

Serializable, Cloneable

알려진 직계 서브 클래스:

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 부호 시 부호: + -
 어느 쪽인지 때: 숫자 숫자 숫자 분: 숫자 숫자 숫자: 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: 숫자 숫자 분: 숫자 숫자 숫자: 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)로서 설정되어 소정의 최신 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