DateTime.Add(TimeSpan) メソッド


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

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



正または負の時間間隔。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回の操作で複数の種類の時間間隔 (日、時間、分、秒、またはミリ秒) を追加できます。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 構造体は、各時間間隔に対して特殊な追加メソッド (AddDaysAddHoursAddMinutesなど) もサポートします。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. 新しい DateTime インスタンスの Kind プロパティは、現在のインスタンスのプロパティと同じです。The Kind property of the new DateTime instance is the same as that of the current instance.