DateTime.Add(TimeSpan) 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

DateTime.cs

回傳一個新值 DateTime ，將指定的 TimeSpan 值加到該實例的值上。

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 方法在一次操作中加入多種時間區間（天、小時、分鐘、秒或毫秒）。 此方法的行為與加法運算子相同。 結構 DateTime 也支援每個時間區間的專用加法方法（如 AddDays、 AddHours、 AddMinutes和 ）。

此 Add 方法在進行日期算術時會考慮閏年及月份的天數。

此方法不會改變此 DateTime值。 取而代之的是，它回傳一個新值 DateTime ，其值即為該操作的結果。 Kind新DateTime實例的性質與當前實例相同。

另請參閱

• TimeSpan
• Add(TimeSpan)
• 使用日期與時間進行算術運算