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回の操作で複数の種類の時間間隔 (日、時間、分、秒、またはミリ秒) を追加できます。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.

適用対象

こちらもご覧ください