DateTime.Add(TimeSpan) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

DateTime.cs

指定したTimeSpanの値をこのインスタンスの値に追加する新しいDateTimeを返します。

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

正または負の時間間隔。

返品

DateTime

このインスタンスで表される日時と、 valueで表される時間間隔の合計を値とするオブジェクト。

例外

ArgumentOutOfRangeException

結果の DateTime が DateTime.MinValue より小さいか 、DateTime.MaxValue より大きい。

例

次の例では、 Add メソッドを示します。 この時点から 36 日 (864 時間) の曜日を計算します。

// Calculate what day of the week is 36 days from this instant.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"

// 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 回の操作で複数の種類の時間間隔 (日、時間、分、秒、またはミリ秒) を追加できます。 このメソッドの動作は、加算演算子の動作と同じです。 DateTime構造では、時間間隔ごとに特殊な追加方法 (AddDays、AddHours、AddMinutesなど) もサポートされます。

Addメソッドでは、日付の算術演算を実行するときに、閏年と月の日数が考慮されます。

このメソッドは、この DateTimeの値を変更しません。 代わりに、この操作の結果である値を持つ新しい DateTime が返されます。 新しいDateTime インスタンスのKind プロパティは、現在のインスタンスのプロパティと同じです。

こちらもご覧ください

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