DateTimeOffset.Add(TimeSpan) DateTimeOffset.Add(TimeSpan) DateTimeOffset.Add(TimeSpan) Method

定義

このインスタンスの値に、指定された時間間隔を加算した新しい DateTimeOffset オブジェクトを返します。Returns a new DateTimeOffset object that adds a specified time interval to the value of this instance.

public:
 DateTimeOffset Add(TimeSpan timeSpan);
public DateTimeOffset Add (TimeSpan timeSpan);
member this.Add : TimeSpan -> DateTimeOffset

パラメーター

timeSpan
TimeSpan TimeSpan TimeSpan

正や負の時間間隔を表す TimeSpan オブジェクト。A TimeSpan object that represents a positive or a negative time interval.

戻り値

現在の DateTimeOffset オブジェクトで表された日時に timeSpan で表された時間間隔を加算した値を示すオブジェクト。An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the time interval represented by timeSpan.

例外

結果として得られる DateTimeOffset 値は MinValue より小さい値です。The resulting DateTimeOffset value is less than MinValue.

- または --or- 結果として得られる DateTimeOffset 値が MaxValue を超えています。The resulting DateTimeOffset value is greater than MaxValue.

次の例の配列を作成するTimeSpan変換先の間の飛行時間を表すオブジェクト。The following example creates an array of TimeSpan objects that represent the flight times between destinations. Addメソッドは、これらの時刻に、追加、DateTimeOffsetフライトの初期離陸時刻を表すオブジェクト。The Add method then adds these times to a DateTimeOffset object that represents a flight's initial takeoff time. 結果は、各転送先に到着予定時刻を反映します。The result reflects the scheduled arrival time at each destination.

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);
}
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 回の操作で時間間隔 (日、時、分、秒またはミリ秒単位) の 1 つ以上の種類を追加します。You can use the Add method to add more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. このメソッドの動作は、加算演算子と同じです。This method's behavior is identical to the addition operator. DateTimeOffset構造体には、追加の特殊なメソッドもサポートしています (などAddDaysAddHours、およびAddMinutes) 時間間隔。The DateTimeOffset structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

注意

このメソッドは、新しい返しますDateTimeOffsetオブジェクト。This method returns a new DateTimeOffset object. 追加して、現在のオブジェクトの値は変更されませんtimeSpanをその日付と時刻。It does not modify the value of the current object by adding timeSpan to its date and time.

Addメソッドでは、現在の値には影響しませんDateTimeOffsetオブジェクトのOffsetプロパティ。The Add method does not affect the value of the current DateTimeOffset object's Offset property.

DateTimeOffsetオブジェクトでは、特定のタイム ゾーンの日時を表していません、Addメソッドでは、特定のタイム ゾーン調整規則の日付と時刻の演算を実行するときは考慮されません。Because a DateTimeOffset object does not represent the date and time in a specific time zone, the Add method does not consider a particular time zone's adjustment rules when it performs date and time arithmetic.

場合、timeSpanパラメーターがnull、このメソッドは、元の値を返しますDateTimeOffsetオブジェクトは変更されません。If the timeSpan parameter is null, this method returns the value of the original DateTimeOffset object unchanged.

適用対象

こちらもご覧ください