DateTimeOffset.ToLocalTime メソッド

定義

現在の DateTimeOffset オブジェクトを、現地時刻を表す DateTimeOffset オブジェクトに変換します。

public DateTimeOffset ToLocalTime ();

戻り値

現在の DateTimeOffset オブジェクトの日時を現地時刻に変換した値を表すオブジェクト。

次の例では、 メソッドを ToLocalTime 使用して、値を DateTimeOffset 太平洋標準時ゾーンの現地時刻に変換します。 また、ローカル タイム ゾーンの調整規則に対するメソッドのサポートも示しています。

// Local time changes on 3/11/2007 at 2:00 AM
DateTimeOffset originalTime, localTime;

originalTime = new DateTimeOffset(2007, 3, 11, 3, 0, 0,
                                  new TimeSpan(-6, 0, 0));
localTime = originalTime.ToLocalTime();
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(),
                                           localTime.ToString());

originalTime = new DateTimeOffset(2007, 3, 11, 4, 0, 0,
                                  new TimeSpan(-6, 0, 0));
localTime = originalTime.ToLocalTime();
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(),
                                           localTime.ToString());

// Define a summer UTC time
originalTime = new DateTimeOffset(2007, 6, 15, 8, 0, 0,
                                  TimeSpan.Zero);
localTime = originalTime.ToLocalTime();
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(),
                                           localTime.ToString());

// Define a winter time
originalTime = new DateTimeOffset(2007, 11, 30, 14, 0, 0,
                                  new TimeSpan(3, 0, 0));
localTime = originalTime.ToLocalTime();
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(),
                                           localTime.ToString());
// The example produces the following output:
//    Converted 3/11/2007 3:00:00 AM -06:00 to 3/11/2007 1:00:00 AM -08:00.
//    Converted 3/11/2007 4:00:00 AM -06:00 to 3/11/2007 3:00:00 AM -07:00.
//    Converted 6/15/2007 8:00:00 AM +00:00 to 6/15/2007 1:00:00 AM -07:00.
//    Converted 11/30/2007 2:00:00 PM +03:00 to 11/30/2007 3:00:00 AM -08:00.

注釈

ローカル時刻への変換を実行する場合、メソッドは最初に現在のオブジェクトの日付と時刻を協定世界時 (UTC) に変換 DateTimeOffset し、時刻からオフセットを減算します。 その後、ローカル タイム ゾーン オフセットを追加して、UTC の日付と時刻を現地時刻に変換します。 これを行う際には、ローカル タイム ゾーンの調整規則が考慮されます。

現在 DateTimeOffset のオブジェクトの値とメソッド呼び出しによって返されるオブジェクトの値の DateTimeOffset 両方が、同じ時点を表します。 つまり、両方が メソッドに DateTimeOffset.Equals(DateTimeOffset, DateTimeOffset) 渡された場合、 メソッドは を返します true

変換によって型の範囲外DateTimeOffsetの時刻が発生した場合、ToLocalTimeメソッドは、日付と時刻が または MaxValueMinValue に設定され、オフセットがローカル タイム ゾーン オフセットに設定されているオブジェクトを返DateTimeOffsetします。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

こちらもご覧ください