DateTime.Add(TimeSpan) 方法

定义

返回一个新的 DateTime,它将指定 TimeSpan 的值添加到此实例的值上。

C#
public DateTime Add(TimeSpan value);

参数

value
TimeSpan

正或负时间间隔。

返回

一个对象,其值是此实例所表示的日期和时间与 value 所表示的时间间隔之和。

例外

示例

下面的示例演示 Add 方法。 它计算从此刻起 36 天 (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 还支持每个时间间隔的专用加法 (,如 AddDaysAddHoursAddMinutes) 。

执行日期算术时, Add 方法会考虑闰年和一个月中的天数。

此方法不会更改此 DateTime的值。 相反,它返回一个新的 DateTime ,其值是此操作的结果。 KindDateTime实例的 属性与当前实例的 属性相同。

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

另请参阅