TimeZone (Java Platform SE 7)

java.lang.Object
- java.util.TimeZone

すべての実装されたインタフェース:

Serializable, Cloneable

直系の既知のサブクラス:

SimpleTimeZone
```
public abstract class TimeZone
extends Object
implements Serializable, Cloneable
```
TimeZone は、タイムゾーンオフセットを表します。また、サマータイムを認識します。
通常は、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()
唯一のコンストラクタです。

コンストラクタ
コンストラクタと説明
`TimeZone()` 唯一のコンストラクタです。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`Object`	`clone()` この `TimeZone` のコピーを作成します。
`static String[]`	`getAvailableIDs()` サポートされる利用可能な ID をすべて取得します。
`static String[]`	`getAvailableIDs(int rawOffset)` ミリ秒単位で指定されたタイムゾーンオフセットと一致する ID で使用可能なものを取得します。
`static TimeZone`	`getDefault()` このホストのデフォルトの `TimeZone` を取得します。
`String`	`getDisplayName()` デフォルトロケールでのユーザーへの表示に適した、この `TimeZone` の標準時の長い名前を返します。
`String`	`getDisplayName(boolean daylight, int style)` デフォルトロケールでのユーザーへの表示に適した、この `TimeZone` の指定された `style` での名前を返します。
`String`	`getDisplayName(boolean daylight, int style, Locale locale)` 指定された `locale` でのユーザーへの表示に適した、この `TimeZone` の指定された `style` での名前を返します。
`String`	`getDisplayName(Locale locale)` 指定された `locale` でのユーザーへの表示に適した、この `TimeZone` の標準時の長い名前を返します。
`int`	`getDSTSavings()` ローカルウォール時計時間を取得するために、ローカルの標準時間に追加する時間の量を返します。
`String`	`getID()` 現在の所在地のタイムゾーンの ID を取得します。
`abstract int`	`getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)` 現在の日付のタイムゾーンオフセットを返します。夏時間の期間内であれば修正されています。
`int`	`getOffset(long date)` 指定された日付で UTC からのこのタイムゾーンのオフセットを返します。
`abstract int`	`getRawOffset()` このタイムゾーンの標準時間を取得するために、UTC に追加するミリ秒単位の時間量を返します。
`static TimeZone`	`getTimeZone(String ID)` 指定された ID の `TimeZone` を取得します。
`boolean`	`hasSameRules(TimeZone other)` このゾーンが比較される別のゾーンと同じ規則とオフセットを持つ場合に true を返します。
`abstract boolean`	`inDaylightTime(Date date)` 指定された `date` が、このタイムゾーンでは夏時間の期間内かどうかを問い合わせます。
`boolean`	`observesDaylightTime()` この `TimeZone` が現在夏時間の期間内にある場合、または標準時間から夏時間への移行が今後行われる場合に `true` を返します。
`static void`	`setDefault(TimeZone zone)` `getDefault` メソッドで返される `TimeZone` を設定します。
`void`	`setID(String ID)` タイムゾーン ID を設定します。
`abstract void`	`setRawOffset(int offsetMillis)` GMT へのベースタイムゾーンオフセットを設定します。
`abstract boolean`	`useDaylightTime()` この `TimeZone` が夏時間を使用するかどうかを問い合わせます。

クラス 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)
```
    現在の日付のタイムゾーンオフセットを返します。夏時間の期間内であれば修正されています。これは、ローカルタイムを取得するために UTC に追加するオフセットです。
    基本となる TimeZone 実装サブクラスが、夏時間スケジュールと GMT オフセットの歴史的変化をサポートする場合、このメソッドは歴史的に正確なオフセットを返します。
    
    パラメータ:
    era - 指定する日付の年号。
    year - 指定する日付の年。
    month - 指定する日付の月。月は 0 から始まる。 0 が 1 月
    day - 指定する日付の日。
    dayOfWeek - 指定する日付の曜日。
    milliseconds - 標準ローカルタイムでの、指定された日のミリ秒。
    
    戻り値:
    ローカルタイムを取得するために GMT に追加するミリ秒単位のオフセット
    関連項目:
    Calendar.ZONE_OFFSET, Calendar.DST_OFFSET
  - getOffset
```
public int getOffset(long date)
```
    指定された日付で UTC からのこのタイムゾーンのオフセットを返します。夏時間が指定された日付で実施されている場合、オフセット値は夏時間の量で調節されます。
    基本となる TimeZone 実装サブクラスが、夏時間スケジュールと GMT オフセットの歴史的変化をサポートする場合、このメソッドは歴史的に正確なオフセット値を返します。
    
    パラメータ:
    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 へのベースタイムゾーンオフセットを設定します。これは、ローカルタイムを取得するために UTC に追加するオフセットです。
    基盤となる TimeZone 実装サブクラスが、GMT オフセットの歴史的変化をサポートする場合、指定された GMT オフセットが最新の GMT オフセットとして設定され、既知の最新 GMT オフセット値との差を使用して、歴史上のすべての GMT オフセット値が調整されます。
    
    パラメータ:
    offsetMillis - 指定された GMT へのベースタイムゾーンオフセット
  - getRawOffset
```
public abstract int getRawOffset()
```
    このタイムゾーンの標準時間を取得するために、UTC に追加するミリ秒単位の時間量を返します。この値は夏時間によって影響を受けないので、直接計算したオフセットと呼ばれます。
    基本となる TimeZone 実装サブクラスが GMT オフセットの歴史的変化をサポートする場合、メソッドは現在の日付の直接計算されたオフセット値を返します。たとえばホノルルでは、1947 年に直接計算されたオフセットが GMT-10:30 から GMT-10:00 に変更したので、このメソッドは常に -36000000 ミリ秒 (つまり -10 時間) を返します。
    
    戻り値:
    UTC に追加される、ミリ秒単位の直接計算されたオフセット時間の量
    関連項目:
    Calendar.ZONE_OFFSET
  - getID
```
public String getID()
```
    現在の所在地のタイムゾーンの ID を取得します。
    
    戻り値:
    現在の所在地のタイムゾーンの ID
  - setID
```
public void setID(String ID)
```
    タイムゾーン ID を設定します。タイムゾーンオブジェクト内のほかのデータは変更されません。
    
    パラメータ:
    ID - 新しいタイムゾーン ID。
  - getDisplayName
```
public final String getDisplayName()
```
    デフォルトロケールでのユーザーへの表示に適した、この TimeZone の標準時の長い名前を返します。
    このメソッドは、次と同等です。
```
 getDisplayName(false, LONG,
                Locale.getDefault(Locale.Category.DISPLAY))
 
```
    戻り値:
    デフォルトロケールでの現在のタイムゾーンを、人が理解できる形式にした名前
    導入されたバージョン:
    
    1.2
    
    関連項目:
    getDisplayName(boolean, int, Locale), Locale.getDefault(Locale.Category), Locale.Category
  - getDisplayName
```
public final String getDisplayName(Locale locale)
```
    指定された locale でのユーザーへの表示に適した、この TimeZone の標準時の長い名前を返します。
    このメソッドは、次と同等です。
```
 getDisplayName(false, LONG, locale)
 
```
    パラメータ:
    locale - 表示名を提供する際に使われるロケール。
    
    戻り値:
    指定されたロケールでの現在のタイムゾーンを、人が理解できる形式にした名前
    
    例外:
    
    NullPointerException - locale が null の場合。
    導入されたバージョン:
    
    1.2
    
    関連項目:
    getDisplayName(boolean, int, Locale)
  - getDisplayName
```
public final String getDisplayName(boolean daylight,
                    int style)
```
    デフォルトロケールでのユーザーへの表示に適した、この TimeZone の指定された style での名前を返します。指定された daylight が true の場合は、夏時間の名前が返されます (この TimeZone が夏時間に従わない場合でも)。それ以外の場合は、標準時の名前が返されます。
    このメソッドは、次と同等です。
```
 getDisplayName(daylight, style,
                Locale.getDefault(Locale.Category.DISPLAY))
 
```
    パラメータ:
    daylight - 夏時間の名前を示す true、または標準時の名前を示す false
    style - LONG または SHORT
    
    戻り値:
    デフォルトロケールでの現在のタイムゾーンを、人が理解できる形式にした名前
    
    例外:
    
    IllegalArgumentException - style が無効である場合
    導入されたバージョン:
    
    1.2
    
    関連項目:
    getDisplayName(boolean, int, Locale), Locale.getDefault(Locale.Category), Locale.Category, DateFormatSymbols.getZoneStrings()
  - getDisplayName
```
public String getDisplayName(boolean daylight,
                    int style,
                    Locale locale)
```
    指定された locale でのユーザーへの表示に適した、この TimeZone の指定された style での名前を返します。指定された daylight が true の場合は、夏時間の名前が返されます (この TimeZone が夏時間に従わない場合でも)。それ以外の場合は、標準時の名前が返されます。
    タイムゾーン名の検索時は、指定された locale から導かれたデフォルトの ResourceBundle の Locale 検索パスが使用されます。(フォールバック Locale の検索は行われません。)検索パスのいずれかの Locale (Locale.ROOT も含む) にタイムゾーン名が見つかった場合は、その名前が返されます。それ以外の場合は、正規化されたカスタム ID 形式の文字列が返されます。
    
    パラメータ:
    daylight - 夏時間の名前を示す true、または標準時の名前を示す false
    style - LONG または SHORT
    locale - 表示名を提供する際に使われるロケール。
    
    戻り値:
    指定されたロケールでの現在のタイムゾーンを、人が理解できる形式にした名前
    
    例外:
    
    IllegalArgumentException - style が無効である場合
    
    NullPointerException - locale が null の場合。
    導入されたバージョン:
    
    1.2
    
    関連項目:
    DateFormatSymbols.getZoneStrings()
  - getDSTSavings
```
public int getDSTSavings()
```
    ローカルウォール時計時間を取得するために、ローカルの標準時間に追加する時間の量を返します。
    useDaylightTime() の呼び出しが true を返す場合、デフォルト実装は 3600000 ミリ秒 (つまり 1 時間) を返します。従わない場合は、0 を返します。
    基本となる TimeZone 実装サブクラスが、夏時間スケジュールの歴史的および将来の変化をサポートする場合、このメソッドは既知の最新夏時間規則の夏時間量を返します。この規則は将来に予測されるものです。
    特定のタイムスタンプにおける夏時間量が必要な場合は、この TimeZone とタイムスタンプを使用して Calendar を構築し、Calendar.get(Calendar.DST_OFFSET) を呼び出します。
    
    戻り値:
    ミリ秒単位の夏時間の量
    導入されたバージョン:
    
    1.4
    
    関連項目:
    inDaylightTime(Date), getOffset(long), getOffset(int,int,int,int,int,int), Calendar.ZONE_OFFSET
  - useDaylightTime
```
public abstract boolean useDaylightTime()
```
    この TimeZone が夏時間を使用するかどうかを問い合わせます。
    基本となる TimeZone 実装サブクラスが、夏時間スケジュールの歴史的および将来の変化をサポートする場合、このメソッドは既知の最新夏時間規則を参照します。この規則は将来に予測されるものであり、現在の規則とは異なる場合があります。現在の規則も考慮する必要がある場合は、observesDaylightTime() を呼び出すようにしてください。
    
    戻り値:
    この TimeZone が夏時間を使用する場合は true、それ以外の場合は false。
    関連項目:
    inDaylightTime(Date), Calendar.DST_OFFSET
  - observesDaylightTime
```
public boolean observesDaylightTime()
```
    この TimeZone が現在夏時間の期間内にある場合、または標準時間から夏時間への移行が今後行われる場合に true を返します。
    useDaylightTime() または inDaylightTime(new Date()) が true を返す場合、デフォルト実装は true を返します。
    
    戻り値:
    この TimeZone が現在夏時間の期間内にある場合、または標準時間から夏時間への移行が今後行われる場合は true。それ以外の場合は false。
    導入されたバージョン:
    
    1.7
    
    関連項目:
    useDaylightTime(), inDaylightTime(Date), Calendar.DST_OFFSET
  - inDaylightTime
```
public abstract boolean inDaylightTime(Date 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)
```
    ミリ秒単位で指定されたタイムゾーンオフセットと一致する ID で使用可能なものを取得します。
    
    パラメータ:
    rawOffset - ミリ秒単位で指定されたタイムゾーンの GMT オフセット。
    
    戻り値:
    ID の配列。配列内の ID のタイムゾーンは、指定された GMT オフセットを持つ。たとえば、「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)
```
    このゾーンが比較される別のゾーンと同じ規則とオフセットを持つ場合に true を返します。つまり、このゾーンの ID だけが異なる場合には true を返します。ほかのゾーンが null の場合は false を返します。
    
    パラメータ:
    other - 比較対象の TimeZone オブジェクト
    
    戻り値:
    他のゾーンが null で、このゾーンと ID 以外はまったく同じ場合は true
    導入されたバージョン:
    
    1.2
  - clone
```
public Object clone()
```
    この TimeZone のコピーを作成します。
    
    オーバーライド:
    
    clone、クラス: Object
    
    戻り値:
    この TimeZone の複製
    関連項目:
    Cloneable

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス TimeZone

3 文字のタイムゾーン ID

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

フィールドの詳細

SHORT

LONG

コンストラクタの詳細

TimeZone

メソッドの詳細

getOffset

getOffset

setRawOffset

getRawOffset

getID

setID

getDisplayName

getDisplayName

getDisplayName

getDisplayName

getDSTSavings

useDaylightTime

observesDaylightTime

inDaylightTime

getTimeZone

getAvailableIDs

getAvailableIDs

getDefault

setDefault

hasSameRules

clone