DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) Method

定義

このインスタンスの値に、指定された TimeSpan の値を加算した新しい DateTime を返します。Returns a new DateTime that adds the value of the specified TimeSpan to the value of this instance.

public:
 DateTime Add(TimeSpan value);
public DateTime Add (TimeSpan value);
member this.Add : TimeSpan -> DateTime
Public Function Add (value As TimeSpan) As DateTime

パラメーター

value
TimeSpan TimeSpan TimeSpan TimeSpan

正または負の時間間隔。A positive or negative time interval.

戻り値

このインスタンスで表された日付と時刻に value で表された時間間隔を加算した値を保持するオブジェクト。An object whose value is the sum of the date and time represented by this instance and the time interval represented by value.

例外

結果として返された DateTimeMinValue より小さいか、MaxValue より大きいです。The resulting DateTime is less than MinValue or greater than MaxValue.

次の例で、Addメソッド。The following example demonstrates the Add method. この時点から 36 日 (864 時間) である週の曜日を計算します。It calculates the day of the week that is 36 days (864 hours) from this moment.

// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 36, 0, 0, 0 );
System::DateTime answer = today.Add( duration );
System::Console::WriteLine( " {0:dddd}", answer );
// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);
' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)

注釈

使用することができます、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 that of the addition operator. DateTime構造体には、追加の特殊なメソッドもサポートしています (などAddDaysAddHours、およびAddMinutes) 時間間隔。The DateTime structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

Addアカウントうるう年と算術演算のときに日付を実行する月内の日数の数を受け取ります。The Add method takes into account leap years and the number of days in a month when performing date arithmetic.

このメソッドには、この値は変わりません。DateTimeします。This method does not change the value of this DateTime. 代わりに、新しい返しますDateTime値がこの操作の結果。Instead, it returns a new DateTime whose value is the result of this operation. Kindプロパティの新しいDateTimeインスタンスが現在のインスタンスと同じです。The Kind property of the new DateTime instance is the same as that of the current instance.

適用対象

こちらもご覧ください