DateTimeOffset.Add(TimeSpan) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

傳回新的 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)
• 使用日期和時間執行算數運算