DateTime.Add(TimeSpan) 方法

定義

命名空間:

System

組件:

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 方法。 它會計算從這一刻起 (864 小時) 一周的星期幾。

// 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.
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)
• 使用日期和時間執行算數運算