DateTimeOffset.Add(TimeSpan) メソッド

定義

このインスタンスの値に、指定された時間間隔を加算した新しい 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 オブジェクトで表された日時に timeSpan で表された時間間隔を加算した値を示すオブジェクト。

例外

結果 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、時間間隔ごとに特殊な追加メソッド (、 AddHoursAddMinutesなどAddDays) もサポートされています。

注意

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

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

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

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

適用対象

こちらもご覧ください