* #### SHORT
public static final int SHORT
「PST」などの短い名前を示す`getDisplayName()`のスタイル指示子です。
導入されたバージョン:
1.2
関連項目:
[LONG](#LONG)、[定数フィールド値](../../../constant-values.html#java.util.TimeZone.SHORT)
* #### LONG
public static final int LONG
「Pacific Standard Time」などの長い名前を示す`getDisplayName()`のスタイル指示子です。
導入されたバージョン:
1.2
関連項目:
[SHORT](#SHORT)、[定数フィールド値](../../../constant-values.html#java.util.TimeZone.LONG)
コンストラクタの詳細
* #### 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.html#ZONE%5FOFFSET), [Calendar.DST\_OFFSET](Calendar.html#DST%5FOFFSET)
* #### getOffset
public int getOffset(long date)
指定された日付でUTCからのこのタイムゾーンのオフセットを返します。 夏時間が指定された日付で実施されている場合、オフセット値は夏時間の量で調節されます。
基本となるTimeZone実装サブクラスが、夏時間スケジュールとGMTオフセットの歴史的変化をサポートする場合、このメソッドは歴史的に正確なオフセット値を返します。
パラメータ:
`date` \- 1970年1月1日00:00:00 GMTからの、ミリ秒単位で表された日付。
戻り値:
ローカル・タイムを取得するためにUTCに追加するミリ秒単位の時間の量
導入されたバージョン:
1.4
関連項目:
[Calendar.ZONE\_OFFSET](Calendar.html#ZONE%5FOFFSET), [Calendar.DST\_OFFSET](Calendar.html#DST%5FOFFSET)
* #### 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](Calendar.html#ZONE%5FOFFSET)
* #### getID
public [String](../lang/String.html "class in java.lang") getID()
現在の所在地のタイムゾーンのIDを取得します。
戻り値:
現在の所在地のタイムゾーンのID
* #### setID
public void setID([String](../lang/String.html "class in java.lang") ID)
タイムゾーンIDを設定します。 タイムゾーン・オブジェクト内のほかのデータは変更されません。
パラメータ:
`ID` \- 新しいタイムゾーンID。
* #### getDisplayName
public final [String](../lang/String.html "class in java.lang") getDisplayName()
デフォルト・ロケールでのユーザーへの表示に適した、この`TimeZone`の標準時の長い名前を返します。
このメソッドは、次と同等です。
> getDisplayName(false, [LONG](#LONG),
> Locale.getDefault([Locale.Category.DISPLAY](Locale.Category.html#DISPLAY)))
>
戻り値:
デフォルト・ロケールでの現在のタイムゾーンを、人が理解できる形式にした名前
導入されたバージョン:
1.2
関連項目:
[getDisplayName(boolean, int, Locale)](#getDisplayName%28boolean,int,java.util.Locale%29), [Locale.getDefault(Locale.Category)](Locale.html#getDefault%28java.util.Locale.Category%29), [Locale.Category](Locale.Category.html)
* #### getDisplayName
public final [String](../lang/String.html "class in java.lang") getDisplayName([Locale](Locale.html "class in java.util") locale)
指定された`locale`でのユーザーへの表示に適した、この`TimeZone`の標準時の長い名前を返します。
このメソッドは、次と同等です。
> getDisplayName(false, [LONG](#LONG), locale)
>
パラメータ:
`locale` \- 表示名を提供する際に使われるロケール。
戻り値:
指定されたロケールでの現在のタイムゾーンを、人が理解できる形式にした名前
例外:
`[NullPointerException](../lang/NullPointerException.html)` \- `locale`が`null`の場合。
導入されたバージョン:
1.2
関連項目:
[getDisplayName(boolean, int, Locale)](#getDisplayName%28boolean,int,java.util.Locale%29)
* #### getDisplayName
public final [String](../lang/String.html "class in java.lang") getDisplayName(boolean daylight,
int style)
デフォルト・ロケールでのユーザーへの表示に適した、この`TimeZone`の指定された`style`での名前を返します。 指定された`daylight`が`true`の場合は、夏時間の名前が返されます(この`TimeZone`が夏時間に従わない場合でも)。 それ以外の場合は、標準時の名前が返されます。
このメソッドは、次と同等です。
> getDisplayName(daylight, style,
> Locale.getDefault([Locale.Category.DISPLAY](Locale.Category.html#DISPLAY)))
>
パラメータ:
`daylight` \- 夏時間の名前を示す`true`、または標準時の名前を示す`false`
`style` \- [LONG](#LONG)または[SHORT](#SHORT)
戻り値:
デフォルト・ロケールでの現在のタイムゾーンを、人が理解できる形式にした名前
例外:
`[IllegalArgumentException](../lang/IllegalArgumentException.html)` \- `style`が無効である場合
導入されたバージョン:
1.2
関連項目:
[getDisplayName(boolean, int, Locale)](#getDisplayName%28boolean,int,java.util.Locale%29), [Locale.getDefault(Locale.Category)](Locale.html#getDefault%28java.util.Locale.Category%29), [Locale.Category](Locale.Category.html), [DateFormatSymbols.getZoneStrings()](../text/DateFormatSymbols.html#getZoneStrings%28%29)
* #### getDisplayName
public [String](../lang/String.html "class in java.lang") getDisplayName(boolean daylight,
int style,
[Locale](Locale.html "class in java.util") locale)
指定された` locale`でのユーザーへの表示に適した、この`TimeZone`の指定された`style`での名前を返します。 指定された`daylight`が`true`の場合は、夏時間の名前が返されます(この`TimeZone`が夏時間に従わない場合でも)。 それ以外の場合は、標準時の名前が返されます。
タイムゾーン名を検索するときは、指定された`locale`から派生した[「デフォルトのLocale ResourceBundleの検索パス」](ResourceBundle.Control.html#getCandidateLocales%28java.lang.String,java.util.Locale%29)が使用されます。 ([フォール・バックLocale](ResourceBundle.Control.html#getFallbackLocale%28java.lang.String,java.util.Locale%29)の検索は行われません。) 検索パスのいずれかの`Locale` ([Locale.ROOT](Locale.html#ROOT)も含む)にタイムゾーン名が見つかった場合は、その名前が返されます。 それ以外の場合は、[正規化されたカスタムID形式](#NormalizedCustomID)の文字列が返されます。
パラメータ:
`daylight` \- 夏時間の名前を示す`true`、または標準時の名前を示す`false`
`style` \- [LONG](#LONG)または[SHORT](#SHORT)
`locale` \- 表示名を提供する際に使われるロケール。
戻り値:
指定されたロケールでの現在のタイムゾーンを、人が理解できる形式にした名前
例外:
`[IllegalArgumentException](../lang/IllegalArgumentException.html)` \- `style`が無効である場合
`[NullPointerException](../lang/NullPointerException.html)` \- `locale`が`null`の場合。
導入されたバージョン:
1.2
関連項目:
[DateFormatSymbols.getZoneStrings()](../text/DateFormatSymbols.html#getZoneStrings%28%29)
* #### getDSTSavings
public int getDSTSavings()
ローカル・ウォール時計時間を取得するために、ローカルの標準時間に追加する時間の量を返します。
[useDaylightTime()](#useDaylightTime%28%29)の呼出しが`true`を返す場合、デフォルト実装は3600000ミリ秒(つまり1時間)を返します。 そうでない場合は、0を返します。
基本となる`TimeZone`実装サブクラスが、夏時間スケジュールの歴史的および将来の変化をサポートする場合、このメソッドは既知の最新夏時間ルールの夏時間量を返します。このルールは将来に予測されるものです。
特定のタイムスタンプにおける夏時間量が必要な場合は、この` TimeZone`とタイムスタンプを使用して[Calendar](Calendar.html)を構築し、[Calendar.get](Calendar.html#get%28int%29)`(`[Calendar.DST\_OFFSET](Calendar.html#DST%5FOFFSET)`)`を呼び出します。
戻り値:
ミリ秒単位の夏時間の量
導入されたバージョン:
1.4
関連項目:
[inDaylightTime(Date)](#inDaylightTime%28java.util.Date%29), [getOffset(long)](#getOffset%28long%29), [getOffset(int,int,int,int,int,int)](#getOffset%28int,int,int,int,int,int%29), [Calendar.ZONE\_OFFSET](Calendar.html#ZONE%5FOFFSET)
* #### useDaylightTime
public abstract boolean useDaylightTime()
この`TimeZone`が夏時間を使用するかどうかを問い合わせます。
基本となる`TimeZone`実装サブクラスが、夏時間スケジュールの歴史的および将来の変化をサポートする場合、このメソッドは既知の最新夏時間ルールを参照します。このルールは将来に予測されるものであり、現在のルールとは異なる場合があります。 現在のルールも考慮する必要がある場合は、[observesDaylightTime()](#observesDaylightTime%28%29)を呼び出すようにしてください。
戻り値:
この`TimeZone`が夏時間を使用する場合は`true`、それ以外の場合は`false`。
関連項目:
[inDaylightTime(Date)](#inDaylightTime%28java.util.Date%29), [Calendar.DST\_OFFSET](Calendar.html#DST%5FOFFSET)
* #### observesDaylightTime
public boolean observesDaylightTime()
この`TimeZone`が現在夏時間の期間内にある場合、または標準時間から夏時間への移行が今後行われる場合に`true`を返します。
`useDaylightTime()`または`inDaylightTime(new Date())`が`true`を返す場合、デフォルト実装は`true`を返します。
戻り値:
この`TimeZone`が現在夏時間の期間内にある場合、または標準時間から夏時間への移行が今後行われる場合は`true`。それ以外の場合は`false`。
導入されたバージョン:
1.7
関連項目:
[useDaylightTime()](#useDaylightTime%28%29), [inDaylightTime(Date)](#inDaylightTime%28java.util.Date%29), [Calendar.DST\_OFFSET](Calendar.html#DST%5FOFFSET)
* #### inDaylightTime
public abstract boolean inDaylightTime([Date](Date.html "class in java.util") date)
指定された`date`が、このタイムゾーンでは夏時間の期間内かどうかを問い合わせます。
パラメータ:
`date` \- 指定されたDate
戻り値:
指定された日付が夏時間の期間内の場合は`true`、そうでない場合は`false`。
* #### getTimeZone
public static [TimeZone](TimeZone.html "class in java.util") getTimeZone([String](../lang/String.html "class in java.lang") ID)
指定されたIDの`TimeZone`を取得します。
パラメータ:
`ID` \- `TimeZone`のID。「PST」のような短縮形式、「America/Los\_Angeles」のような完全な名前、あるいは「GMT-8:00」のようなカスタムIDのどれか。 短縮形式は、JDK 1.1.xとの互換性のためだけにサポートされているため、完全な名前を使用する必要がある
戻り値:
指定された`TimeZone`。指定されたIDを認識できない場合はGMTゾーン。
* #### getTimeZone
public static [TimeZone](TimeZone.html "class in java.util") getTimeZone([ZoneId](../time/ZoneId.html "class in java.time") zoneId)
指定された`zoneId`の`TimeZone`を取得します。
パラメータ:
`zoneId` \- タイムゾーンIDの取得元となる[ZoneId](../time/ZoneId.html)
戻り値:
指定された`TimeZone`。指定されたIDを認識できない場合はGMTゾーン。
例外:
`[NullPointerException](../lang/NullPointerException.html)` \- `zoneId`が`null`である場合
導入されたバージョン:
1.8
* #### toZoneId
public [ZoneId](../time/ZoneId.html "class in java.time") toZoneId()
この`TimeZone`オブジェクトを`ZoneId`に変換します。
戻り値:
この`TimeZone`と同じタイムゾーンを表す`ZoneId`
導入されたバージョン:
1.8
* #### getAvailableIDs
public static [String](../lang/String.html "class in java.lang")[] getAvailableIDs(int rawOffset)
ミリ秒単位で指定されたタイムゾーン・オフセットと一致するIDで使用可能なものを取得します。
パラメータ:
`rawOffset` \- ミリ秒単位で指定されたタイムゾーンのGMTオフセット。
戻り値:
IDの配列。配列内のIDのタイムゾーンは、指定されたGMTオフセットを持つ。 たとえば、「America/Phoenix」と「America/Denver」はどちらもGMT-07:00を持つが、夏時間の動作には違いがある。
関連項目:
[getRawOffset()](#getRawOffset%28%29)
* #### getAvailableIDs
public static [String](../lang/String.html "class in java.lang")[] getAvailableIDs()
サポートされる利用可能なIDをすべて取得します。
戻り値:
IDの配列
* #### getDefault
public static [TimeZone](TimeZone.html "class in java.util") getDefault()
Java仮想マシンのデフォルトの`TimeZone`を取得します。 キャッシュされたデフォルトの`TimeZone`が使用可能な場合は、そのクローンが返されます。 それ以外の場合、このメソッドは次のステップに従ってデフォルトのタイムゾーンを判定します。
* `user.timezone`プロパティの値が使用可能な場合は、それをデフォルトのタイムゾーンIDとして使用します。
* プラットフォームのタイムゾーンIDを検出します。 プラットフォームのタイムゾーンとIDのマッピングのソースは、実装によって異なる場合があります。
* 指定または検出されたタイムゾーンIDが不明の場合は、最後の手段として`GMT`を使用します。
このIDから作成されたデフォルトの`TimeZone`がキャッシュされ、そのクローンが返されます。 復帰時に、`user.timezone`プロパティの値はこのIDに設定されます。
戻り値:
デフォルトの`TimeZone`
関連項目:
[setDefault(TimeZone)](#setDefault%28java.util.TimeZone%29)
* #### setDefault
public static void setDefault([TimeZone](TimeZone.html "class in java.util") zone)
`getDefault`メソッドで返される`TimeZone`を設定します。`zone`はキャッシュされています。 `zone`がnullの場合は、キャッシュされたデフォルトの`TimeZone`がクリアされます。 このメソッドは`user.timezone`プロパティの値を変更しません。
パラメータ:
`zone` \- 新しいデフォルトの`TimeZone`、またはnull
例外:
`[SecurityException](../lang/SecurityException.html)` \- セキュリティ・マネージャの`checkPermission`が`PropertyPermission("user.timezone", "write")`を拒否する場合
関連項目:
[getDefault()](#getDefault%28%29), [PropertyPermission](PropertyPermission.html)
* #### hasSameRules
public boolean hasSameRules([TimeZone](TimeZone.html "class in java.util") other)
このゾーンが比較される別のゾーンと同じルールとオフセットを持つ場合にtrueを返します。 つまり、このゾーンのIDだけが異なる場合にはtrueを返します。 ほかのゾーンがnullの場合はfalseを返します。
パラメータ:
`other` \- 比較対象の`TimeZone`オブジェクト
戻り値:
他のゾーンがnullで、このゾーンとID以外はまったく同じ場合はtrue
導入されたバージョン:
1.2
* #### clone
public [Object](../lang/Object.html "class in java.lang") clone()
この`TimeZone`のコピーを作成します。
オーバーライド:
`[clone](../lang/Object.html#clone%28%29)`、クラス`[Object](../lang/Object.html)`
戻り値:
この`TimeZone`の複製
関連項目:
[Cloneable](../lang/Cloneable.html)