DateTime.Add(TimeSpan) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

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.
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)
• 使用日期和时间执行算术运算