この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

TimeZone クラス

タイムゾーンを表します。新しいタイムゾーンを作成し、タイムゾーン ID、オフセット、表示名などのタイムゾーンプロパティを取得するためのメソッドを含みます。

名前空間

System

使用方法

このクラスのメソッドを使用して、UserInfo.getTimeZone から返されるタイムゾーンまたはこのクラスの getTimeZone から返されるタイムゾーンのプロパティなど、タイムゾーンのプロパティを取得できます。

この例では、現在のユーザのタイムゾーンのプロパティを取得し、それをデバッグログに表示する方法を示します。

このサンプルの出力は、ユーザのタイムゾーンによって異なります。ユーザのタイムゾーンが America/Los_Angeles の場合の出力例を次に示します。このタイムゾーンの場合、夏時間は GMT から -7 時間 (-25200000 ミリ秒) であり、標準時間は GMT から -8 時間 (-28800000 ミリ秒) です。

Display name: Pacific Standard Time

ID: America/Los_Angeles

Offset: -25200000

Offset: -28800000

String format: America/Los_Angeles

2 番目の例では、New York のタイムゾーンを作成し、GMT タイムゾーンに対するこのタイムゾーンのオフセットを取得する方法を示します。この例は、オフセットを取得するために 2 つの日付を使用します。1 つの日付は夏時間前、もう 1 つの日付は夏時間後です。2000 年の夏時間は、New York タイムゾーンの 10 月 29 日、日曜日に終了しました。最初の日付は夏時間後であるため、最初の日付のオフセットは GMT に対して –5 時間です。2012 年の夏時間は、11 月 4 日、日曜日に終了しました。2 番目の日付は夏時間中であるため、2 番目の日付のオフセットは –4 時間です。

次の例は前の例と似ていますが、夏時間の境界周辺でオフセットを取得しています。2014 年の夏時間は、New York タイムゾーンの 11 月 2 日、日曜日午前 2 時に終了しました。最初のオフセットは夏時間の終了直前に取得され、2 番目のオフセットは夏時間の終了直後に取得されています。日付は DateTime.newInstanceGMT メソッドを使用して作成されます。このメソッドは、渡される日付値が GMT タイムゾーンに基づくことを前提としています。

TimeZone のメソッド

TimeZone のメソッドは次のとおりです。

getDisplayName()

このタイムゾーンの表示名を返します。

署名

public String getDisplayName()

戻り値

型: String

バージョン管理動作の変更

API バージョン 45.0 以降では、夏時間が有効である場合、getDisplayName で夏時間が適切に表示されます。たとえば、ヨーロッパ/ロンドンでは英国夏時間が表示され、米国/ロサンゼルスでは太平洋夏時間が表示されます。

getID()

このタイムゾーンの ID を返します。

署名

public String getID()

戻り値

型: String

getOffset(date)

指定された日付の GMT タイムゾーンに対するタイムゾーンオフセットをミリ秒単位で返します。

署名

public Integer getOffset(Datetime date)

パラメータ

date
型: Datetime
date 引数は、評価する日時です。

戻り値

型: Integer

使用方法

date 引数がこのタイムゾーンの夏時間の場合、返されたオフセットは夏時間に調整されます。

メモ

getTimeZone(timeZoneIdString)

指定されたタイムゾーン ID に対応するタイムゾーンを返します。

署名

public static TimeZone getTimeZone(String timeZoneIdString)

パラメータ

timeZoneIdString
型: String
Id 引数に使用できるタイムゾーン値は、Java TimeZone クラスでサポートされる有効なタイムゾーン値です。

戻り値

型: TimeZone

toString()

このタイムゾーンを文字列表現で返します。

署名

public String toString()

戻り値

型: String