DateTimeOffset.Add(TimeSpan) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

DateTimeOffset.cs

指定した時間間隔をこのインスタンスの値に追加する新しい DateTimeOffset オブジェクトを返します。

public:
 DateTimeOffset Add(TimeSpan timeSpan);

public DateTimeOffset Add(TimeSpan timeSpan);

member this.Add : TimeSpan -> DateTimeOffset

Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

パラメーター

timeSpan

TimeSpan

正または負の時間間隔を表す TimeSpan オブジェクト。

戻り値

DateTimeOffset

現在の DateTimeOffset オブジェクトで表される日時と、 timeSpanで表される時間間隔の合計を値とするオブジェクト。

例外

ArgumentOutOfRangeException

結果の DateTimeOffset 値が DateTimeOffset.MinValue 未満です。

-又は-

結果の DateTimeOffset 値が DateTimeOffset.MaxValue より大きくなります。

例

次の例では、目的地間の飛行時間を表す TimeSpan オブジェクトの配列を作成します。 その後、 Add メソッドは、フライトの最初の離陸時間を表す DateTimeOffset オブジェクトにこれらの時刻を追加します。 結果には、各宛先でのスケジュールされた到着時刻が反映されます。

DateTimeOffset takeOff = new DateTimeOffset(2007, 6, 1, 7, 55, 0,
                             new TimeSpan(-5, 0, 0));
DateTimeOffset currentTime = takeOff;
TimeSpan[] flightTimes = new TimeSpan[]
                  {new TimeSpan(2, 25, 0), new TimeSpan(1, 48, 0)};
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.",
                  takeOff);
for (int ctr = flightTimes.GetLowerBound(0);
     ctr <= flightTimes.GetUpperBound(0); ctr++)
{
   currentTime = currentTime.Add(flightTimes[ctr]);
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime);
}

let takeOff = DateTimeOffset(2007, 6, 1, 7, 55, 0, TimeSpan(-5, 0, 0))
let mutable currentTime = takeOff
let flightTimes = [| TimeSpan(2, 25, 0); TimeSpan(1, 48, 0) |]
printfn $"Takeoff is scheduled for {takeOff:d} at {takeOff:T}."
                
for i = 0 to flightTimes.Length - 1 do
    currentTime <- currentTime.Add flightTimes[i]
    printfn $"Destination #{i + 1} at {currentTime}."

Dim takeOff As New DateTimeOffset(#6/1/2007 7:55AM#, _
                                  New TimeSpan(-5, 0, 0))
Dim currentTime As DateTimeOffset = takeOff
Dim flightTimes() As TimeSpan = New TimeSpan() _
                  {New TimeSpan(2, 25, 0), New TimeSpan(1, 48, 0)}
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.", _
                  takeOff)
For ctr As Integer = flightTimes.GetLowerBound(0) To _
                     flightTimes.GetUpperBound(0)
   currentTime = currentTime.Add(flightTimes(ctr))
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime)
Next

注釈

Addメソッドを使用すると、1 回の操作で複数の種類の時間間隔 (日、時間、分、秒、またはミリ秒) を追加できます。 このメソッドの動作は、加算演算子と同じです。 DateTimeOffset構造では、時間間隔ごとに特殊な追加方法 (AddDays、AddHours、AddMinutesなど) もサポートされます。

注

このメソッドは、新しい DateTimeOffset オブジェクトを返します。 現在のオブジェクトの日付と時刻に timeSpan を追加しても、現在のオブジェクトの値は変更されません。

Add メソッドは、現在のDateTimeOffset オブジェクトのOffset プロパティの値には影響しません。

DateTimeOffset オブジェクトは特定のタイム ゾーンの日付と時刻を表さないため、Add メソッドは日付と時刻の算術演算を実行するときに特定のタイム ゾーンの調整規則を考慮しません。

timeSpan パラメーターがnull場合、このメソッドは元のDateTimeOffset オブジェクトの値を変更せずに返します。

こちらもご覧ください

• Addition(DateTimeOffset, TimeSpan)
• 日付と時刻を使用した算術演算の実行