DateTimeOffset.Add(TimeSpan) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
返回一个新 DateTimeOffset 对象，该对象将指定的时间间隔添加到此实例的值。
public:
DateTimeOffset Add(TimeSpan timeSpan);public DateTimeOffset Add(TimeSpan timeSpan);member this.Add : TimeSpan -> DateTimeOffsetPublic Function Add (timeSpan As TimeSpan) As DateTimeOffset参数
返回
一个对象，其值为当前 DateTimeOffset 对象所表示的日期和时间和表示的时间间隔之 timeSpan和。
例外
示例
以下示例创建一个对象数组 TimeSpan ，这些对象表示目标之间的飞行时间。 然后，该方法 Add 将这些时间添加到 DateTimeOffset 表示外部测试版初始起飞时间的对象。 结果反映每个目标的计划到达时间。
DateTimeOffset takeOff = new DateTimeOffset(2007, 6, 1, 7, 55, 0,
new TimeSpan(-5, 0, 0));
DateTimeOffset currentTime = takeOff;
TimeSpan[] flightTimes = new TimeSpan[]
{new TimeSpan(2, 25, 0), new TimeSpan(1, 48, 0)};
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.",
takeOff);
for (int ctr = flightTimes.GetLowerBound(0);
ctr <= flightTimes.GetUpperBound(0); ctr++)
{
currentTime = currentTime.Add(flightTimes[ctr]);
Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime);
}
let takeOff = DateTimeOffset(2007, 6, 1, 7, 55, 0, TimeSpan(-5, 0, 0))
let mutable currentTime = takeOff
let flightTimes = [| TimeSpan(2, 25, 0); TimeSpan(1, 48, 0) |]
printfn $"Takeoff is scheduled for {takeOff:d} at {takeOff:T}."
for i = 0 to flightTimes.Length - 1 do
currentTime <- currentTime.Add flightTimes[i]
printfn $"Destination #{i + 1} at {currentTime}."
Dim takeOff As New DateTimeOffset(#6/1/2007 7:55AM#, _
New TimeSpan(-5, 0, 0))
Dim currentTime As DateTimeOffset = takeOff
Dim flightTimes() As TimeSpan = New TimeSpan() _
{New TimeSpan(2, 25, 0), New TimeSpan(1, 48, 0)}
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.", _
takeOff)
For ctr As Integer = flightTimes.GetLowerBound(0) To _
flightTimes.GetUpperBound(0)
currentTime = currentTime.Add(flightTimes(ctr))
Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime)
Next
注解
可以使用该方法 Add 在单个操作中添加多个时间间隔（天、小时、分钟、秒或毫秒）。 此方法的行为与加法运算符相同。 该 DateTimeOffset 结构还支持每个时间间隔的专用加法方法（例如 AddDays， AddHours和 AddMinutes）。
注释
此方法返回一个新 DateTimeOffset 对象。 它不会通过添加到 timeSpan 其日期和时间来修改当前对象的值。
该方法 Add 不会影响当前 DateTimeOffset 对象的 Offset 属性的值。
由于对象 DateTimeOffset 不表示特定时区中的日期和时间， Add 因此该方法在执行日期和时间算术时不考虑特定时区的调整规则。
timeSpan如果参数是null，此方法将返回原始DateTimeOffset对象的值不变。
