DateTimeOffset.Add(TimeSpan) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

DateTimeOffset.cs

返回一个新的 DateTimeOffset 对象，它向此实例的值添加指定的时间间隔。

public:
 DateTimeOffset Add(TimeSpan timeSpan);

public DateTimeOffset Add (TimeSpan timeSpan);

member this.Add : TimeSpan -> DateTimeOffset

Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

参数

timeSpan

TimeSpan

一个 TimeSpan 对象，表示正时间间隔或负时间间隔。

返回

DateTimeOffset

一个对象，其值为当前 DateTimeOffset 对象所表示的日期和时间与 timeSpan 所表示的时间间隔之和。

例外

ArgumentOutOfRangeException

生成的 DateTimeOffset 值小于 DateTimeOffset.MinValue。

\- 或 -

生成的 DateTimeOffset 值大于 DateTimeOffset.MaxValue。

示例

以下示例创建对象的数组 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对象的值不变。

另请参阅

• Addition(DateTimeOffset, TimeSpan)
• 使用日期和时间执行算术运算