TimeZone.ToLocalTime(DateTime) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した日付と時刻の値に対応する現地時刻を返します。
public:
virtual DateTime ToLocalTime(DateTime time);
public virtual DateTime ToLocalTime(DateTime time);
abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTime
Public Overridable Function ToLocalTime (time As DateTime) As DateTime
パラメーター
- time
- DateTime
協定世界時 (UTC) 時刻。
返品
DateTimeに対応するローカル時刻を値とするtime オブジェクト。
注釈
次の表に、 time パラメーターと、このメソッドによって返される DateTime 値の関係を示します。
time パラメーター |
Behavior | 戻り値 |
|---|---|---|
| 協定世界時 (UTC) 時刻 (DateTimeKind.Utc)。 | 時刻を UTC から現地時刻に変換します。 |
DateTimeに対応するローカル時刻を値とするtime オブジェクト。 |
| 現地時刻 (DateTimeKind.Local)。 | 変換は必要ありません。 |
DateTime パラメーターで表されるのと同じtime値。 |
| 指定されていない時刻 (DateTimeKind.Unspecified)。 | 時刻が UTC であることを前提とし、UTC から現地時刻に変換します。 |
DateTimeに対応するローカル時刻を値とするtime オブジェクト。 |
ローカル タイム ゾーンで夏時間が観察される場合、 ToLocalTime は、変換の実行時に現在の調整規則を time に適用します。
Note
ToLocalTimeメソッドは、ローカル タイム ゾーンの現在の夏時間調整規則のみを認識します。 その結果、最新の調整ルールが有効な期間中にのみ、特定の UTC 時刻に対応する現地時刻を正確に返すことができます。
timeが以前の調整規則の対象となった履歴の日付と時刻の値である場合は、不正確な結果が返される可能性があります。
ToLocalTime メソッドは、TimeZoneInfo.ConvertTimeFromUtc パラメーターが destinationTimeZone に設定されたTimeZoneInfo.Local メソッドに対応します。 可能な限り、 TimeZoneInfo.ConvertTimeFromUtc メソッドを使用します。
注意 (継承者)
必須ではありませんが、ほとんどの場合、派生クラスはこのメソッドの既定の実装をオーバーライドする必要があります。 既定の実装の動作は、Kind パラメーターのtime プロパティによって異なります。 その値が Local場合、このメソッドは変更されていない time 返します。 値が Utc または Unspecified の場合、このメソッドは time が UTC であると見なし、 GetUtcOffset(DateTime) メソッドを呼び出さずにローカル システム時刻に変換します。