共用方式為


DateTimeOffset.Add(TimeSpan) 方法

定義

傳回新的 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 物件所表示之日期和時間加上 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 也支援每個時間間隔的特製化加法方法 (,例如 AddDaysAddHoursAddMinutes) 。

注意

這個方法會傳回新的 DateTimeOffset 物件。 它不會藉由將 新增 timeSpan 至物件的日期和時間來修改目前物件的值。

方法 Add 不會影響目前 DateTimeOffset 物件的 Offset 屬性值。

DateTimeOffset因為 物件不代表特定時區中的日期和時間, Add 所以此方法在執行日期和時間算術時,不會考慮特定時區的調整規則。

timeSpan如果 參數為 null ,這個方法會傳回原始 DateTimeOffset 物件的值未變更。

適用於

另請參閱