方法 : 日付と時刻の演算でタイムゾーンを使用する

[アーティクル]
08/09/2011

通常、DateTime 値または DateTimeOffset 値を使用して日付と時刻の演算を実行するとき、その結果にはタイムゾーン調整規則は反映されません。これは、日時の値のタイムゾーンを明確に識別できる場合 (Kind プロパティが Local に設定されている場合など) でも同じです。このトピックでは、特定のタイムゾーンに属する日時の値の算術演算を実行する方法について説明します。算術演算の結果には、タイムゾーンの調整規則が反映されます。

日付と時刻の演算に調整規則を適用するには

なんらかの方法を実装して、日時の値と、その値が属するタイムゾーンを密接に結び付ます。たとえば、日時の値とそのタイムゾーンの両方を含む構造体を宣言します。次の例では、この方法を使用して DateTime 値とそのタイムゾーンをリンクします。
```
' Define a structure for DateTime values for internal use only
Friend Structure TimeWithTimeZone
   Dim TimeZone As TimeZoneInfo
   Dim Time As Date
End Structure
```
```
// Define a structure for DateTime values for internal use only
internal struct TimeWithTimeZone
{
   TimeZoneInfo TimeZone;
   DateTime Time;
}
```
ConvertTimeToUtc メソッドまたは ConvertTime メソッドを呼び出して、時刻を世界協定時刻 (UTC: Coordinated Universal Time) に変換します。
UTC 時刻で算術演算を実行します。
TimeZoneInfo.ConvertTime(DateTime, TimeZoneInfo) メソッドを呼び出して、UTC の時刻から、元の時刻に関連付けられたタイムゾーンの時刻に変換します。

使用例

次の例では、中部標準時の 2008 年 3 月 9 日午前 1 時 30 分に、2 時間 30 分を加えます。夏時間へのタイムゾーンの切り替えは、30 分後の 2008 年 3 月 9 日午前 2 時に発生します。この例は前に示した 4 つの手順に従うので、結果は正しい時刻である 2008 年 3 月 9 日午前 5 時になります。

Public Structure TimeZoneTime
   Public TimeZone As TimeZoneInfo
   Public Time As Date

   Public Sub New(tz As TimeZoneInfo, time As Date)
      If tz Is Nothing Then _
         Throw New ArgumentNullException("The time zone cannot be a null reference.")

      Me.TimeZone = tz
      Me.Time = time
   End Sub

   Public Function AddTime(interval As TimeSpan) As TimeZoneTime
      ' Convert time to UTC
      Dim utcTime As DateTime = TimeZoneInfo.ConvertTimeToUtc(Me.Time, _
                                                              Me.TimeZone)      
      ' Add time interval to time
      utcTime = utcTime.Add(interval)
      ' Convert time back to time in time zone
      Return New TimeZoneTime(Me.TimeZone, TimeZoneInfo.ConvertTime(utcTime, _
                              TimeZoneInfo.Utc, Me.TimeZone))
   End Function
End Structure

Module TimeArithmetic
   Public Const tzName As String = "Central Standard Time"

   Public Sub Main()
      Try
         Dim cstTime1, cstTime2 As TimeZoneTime

         Dim cst As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(tzName)
         Dim time1 As Date = #03/09/2008 1:30AM#
         Dim twoAndAHalfHours As New TimeSpan(2, 30, 0)

         cstTime1 = New TimeZoneTime(cst, time1)
         cstTime2 = cstTime1.AddTime(twoAndAHalfHours)

         Console.WriteLine("{0} + {1} hours = {2}", cstTime1.Time, _
                                                    twoAndAHalfHours.ToString(), _ 
                                                    cstTime2.Time)  
      Catch
         Console.WriteLine("Unable to find {0}.", tzName)
      End Try   
   End Sub   
End Module

using System;

public struct TimeZoneTime
{
   public TimeZoneInfo TimeZone;
   public DateTime Time;

   public TimeZoneTime(TimeZoneInfo tz, DateTime time)
   {
      if (tz == null) 
         throw new ArgumentNullException("The time zone cannot be a null reference.");

      this.TimeZone = tz;
      this.Time = time;   
   }

   public TimeZoneTime AddTime(TimeSpan interval)
   {
      // Convert time to UTC
      DateTime utcTime = TimeZoneInfo.ConvertTimeToUtc(this.Time, this.TimeZone);
      // Add time interval to time
      utcTime = utcTime.Add(interval);
      // Convert time back to time in time zone
      return new TimeZoneTime(this.TimeZone, TimeZoneInfo.ConvertTime(utcTime, 
                              TimeZoneInfo.Utc, this.TimeZone));
   }
}

public class TimeArithmetic
{
   public const string tzName = "Central Standard Time";

   public static void Main()
   {
      try
      {
         TimeZoneTime cstTime1, cstTime2;

         TimeZoneInfo cst = TimeZoneInfo.FindSystemTimeZoneById(tzName);
         DateTime time1 = new DateTime(2008, 3, 9, 1, 30, 0);          
         TimeSpan twoAndAHalfHours = new TimeSpan(2, 30, 0);

         cstTime1 = new TimeZoneTime(cst, time1);
         cstTime2 = cstTime1.AddTime(twoAndAHalfHours);
         Console.WriteLine("{0} + {1} hours = {2}", cstTime1.Time, 
                                                    twoAndAHalfHours.ToString(),  
                                                    cstTime2.Time);
      }
      catch
      {
         Console.WriteLine("Unable to find {0}.", tzName);
      }
   }
}

DateTime 値と DateTimeOffset 値はどちらも、どのタイムゾーンとも関連付けられていません。タイムゾーンの調整規則が自動的に適用されるような方法で日付と時刻の演算を実行するには、日時の値の属するタイムゾーンがすぐに識別できる状態であることが必要です。つまり、日時とそのタイムゾーンを密に結合する必要があります。そのためには、次に示すようにいくつかの方法があります。

アプリケーションで使用されるすべての時刻が、特定のタイムゾーンに属するものと仮定します。この方法は、適切な場合もありますが、柔軟性が限られ、移植性が制限される可能性もあります。
日時とそのタイムゾーンを型のフィールドとして組み込むことで、両者を密に結合する型を定義します。このコード例では、この方法を使用して、日時とタイムゾーンを 2 つのメンバーフィールドに格納する構造体を定義しています。

この例は、タイムゾーンの調整規則が結果に適用されるように DateTime 値の算術演算を実行する方法を示しています。ただし、DateTimeOffset 値も同じように簡単に使用できます。次の例では、DateTime 値の代わりに DateTimeOffset を使用するように、元の例のコードを適合させる方法を示します。

Public Structure TimeZoneTime
   Public TimeZone As TimeZoneInfo
   Public Time As DateTimeOffset

   Public Sub New(tz As TimeZoneInfo, time As DateTimeOffset)
      If tz Is Nothing Then _
         Throw New ArgumentNullException("The time zone cannot be a null reference.")

      Me.TimeZone = tz
      Me.Time = time
   End Sub

   Public Function AddTime(interval As TimeSpan) As TimeZoneTime
      ' Convert time to UTC
      Dim utcTime As DateTimeOffset = TimeZoneInfo.ConvertTime(Me.Time, TimeZoneInfo.Utc)      
      ' Add time interval to time
      utcTime = utcTime.Add(interval)
      ' Convert time back to time in time zone
      Return New TimeZoneTime(Me.TimeZone, TimeZoneInfo.ConvertTime(utcTime, Me.TimeZone))
   End Function
End Structure

Module TimeArithmetic
   Public Const tzName As String = "Central Standard Time"

   Public Sub Main()
      Try
         Dim cstTime1, cstTime2 As TimeZoneTime

         Dim cst As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(tzName)
         Dim time1 As Date = #03/09/2008 1:30AM#
         Dim twoAndAHalfHours As New TimeSpan(2, 30, 0)

         cstTime1 = New TimeZoneTime(cst, _
                        New DateTimeOffset(time1, cst.GetUtcOffset(time1)))
         cstTime2 = cstTime1.AddTime(twoAndAHalfHours)

         Console.WriteLine("{0} + {1} hours = {2}", cstTime1.Time, _
                                                    twoAndAHalfHours.ToString(), _ 
                                                    cstTime2.Time)  
      Catch
         Console.WriteLine("Unable to find {0}.", tzName)
      End Try   
   End Sub   
End Module

using System;

public struct TimeZoneTime
{
   public TimeZoneInfo TimeZone;
   public DateTimeOffset Time;

   public TimeZoneTime(TimeZoneInfo tz, DateTimeOffset time)
   {
      if (tz == null) 
         throw new ArgumentNullException("The time zone cannot be a null reference.");

      this.TimeZone = tz;
      this.Time = time;   
   }

   public TimeZoneTime AddTime(TimeSpan interval)
   {
      // Convert time to UTC
      DateTimeOffset utcTime = TimeZoneInfo.ConvertTime(this.Time, TimeZoneInfo.Utc);      
      // Add time interval to time
      utcTime = utcTime.Add(interval);
      // Convert time back to time in time zone
      return new TimeZoneTime(this.TimeZone, TimeZoneInfo.ConvertTime(utcTime, this.TimeZone));
   }
}

public class TimeArithmetic
{
   public const string tzName = "Central Standard Time";

   public static void Main()
   {
      try
      {
         TimeZoneTime cstTime1, cstTime2;

         TimeZoneInfo cst = TimeZoneInfo.FindSystemTimeZoneById(tzName);
         DateTime time1 = new DateTime(2008, 3, 9, 1, 30, 0);          
         TimeSpan twoAndAHalfHours = new TimeSpan(2, 30, 0);

         cstTime1 = new TimeZoneTime(cst, 
                        new DateTimeOffset(time1, cst.GetUtcOffset(time1)));
         cstTime2 = cstTime1.AddTime(twoAndAHalfHours);
         Console.WriteLine("{0} + {1} hours = {2}", cstTime1.Time, 
                                                    twoAndAHalfHours.ToString(),  
                                                    cstTime2.Time);
      }
      catch
      {
         Console.WriteLine("Unable to find {0}.", tzName);
      }
   }
}

最初に UTC に変換せず、単純に DateTimeOffset 値に対してこの加算を実行すると、結果には正しい時刻が反映されますが、その時刻に対して指定されたタイムゾーンのオフセットは反映されません。

コードのコンパイル

この例で必要な要素は次のとおりです。

System.Core.dll への参照をプロジェクトに追加する。
System 名前空間を using ステートメントでインポートする (C# のコードで必要)。

方法 : 日付と時刻の演算でタイムゾーンを使用する

日付と時刻の演算に調整規則を適用するには

使用例

コードのコンパイル

参照

概念

その他の技術情報

その他のリソース

方法 : 日付と時刻の演算でタイム ゾーンを使用する

日付と時刻の演算に調整規則を適用するには

使用例

コードのコンパイル

参照

概念

その他の技術情報

その他のリソース

方法 : 日付と時刻の演算でタイムゾーンを使用する