DateTimeOffset.Add(TimeSpan) 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

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)
• 使用日期與時間進行算術運算