DateTime.Add(TimeSpan) 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

DateTime.cs

傳回新的 DateTime，將這個執行個體的值加上指定之 TimeSpan 的值。

C#

public DateTime Add(TimeSpan value);

參數

value

TimeSpan

正數或負數時間間隔。

傳回

DateTime

物件，其值為這個執行個體所表示日期和時間加上 value 所表示時間間隔的總和。

例外狀況

ArgumentOutOfRangeException

產生的 DateTime 小於 DateTime.MinValue 或大於 DateTime.MaxValue。

範例

下列範例示範 Add 方法。 它會計算從這一刻起 (864 小時) 一周的星期幾。

C#

// 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);

備註

您可以使用 Add 方法，在單一作業中新增一種以上的時間間隔 (天、小時、分鐘、秒或) 毫秒。 這個方法的行為與加法運算子的行為相同。 結構 DateTime 也支援每個時間間隔的特製化加法方法 (，例如 AddDays 、 AddHours 和 AddMinutes) 。

方法會將 Add 閏年和執行日期算術的月份天數納入考慮。

這個方法不會變更這個 DateTime 的值。 相反地，它會傳回新的 DateTime ，其值為此作業的結果。 Kind新 DateTime 實例的 屬性與目前實例的 屬性相同。

另請參閱

• TimeSpan
• Add(TimeSpan)
• 使用日期和時間執行算數運算