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

[アーティクル]
04/07/2023

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

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

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

例

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

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);
      }
   }
}

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

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

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

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

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);
      }
   }
}

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

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

次の方法で共有

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

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

例

関連項目

その他のリソース

次の方法で共有

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

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

例

関連項目

その他のリソース

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