共用方式為


DateTime.Add(TimeSpan) 方法

定義

傳回新的 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

正數或負數時間間隔。

傳回

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

例外狀況

範例

下列範例示範 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 也支援每個時間間隔的特製化加法方法 (,例如 AddDaysAddHoursAddMinutes) 。

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

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

適用於

另請參閱