DateTimeOffset.Add(TimeSpan) メソッド

public:
 DateTimeOffset Add(TimeSpan timeSpan);

public DateTimeOffset Add (TimeSpan timeSpan);

member this.Add : TimeSpan -> DateTimeOffset

Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

パラメーター

戻り値

現在の DateTimeOffset オブジェクトで表された日時に timeSpan で表された時間間隔を加算した値を示すオブジェクト。

例外

例

次の例では、目的地間の飛行時間を表す オブジェクトの 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) もサポートされています。

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

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

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

適用対象

こちらもご覧ください

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