DateTimeOffset.Add(TimeSpan) Metod

Definition

Namnområde:
System
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs

Returnerar ett nytt DateTimeOffset objekt som lägger till ett angivet tidsintervall till värdet för den här instansen.

public:
 DateTimeOffset Add(TimeSpan timeSpan);
public DateTimeOffset Add(TimeSpan timeSpan);
member this.Add : TimeSpan -> DateTimeOffset
Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

Parametrar

timeSpan
TimeSpan

Ett TimeSpan objekt som representerar ett positivt eller negativt tidsintervall.

Returer

DateTimeOffset

Ett objekt vars värde är summan av datum och tid som representeras av det aktuella DateTimeOffset objektet och tidsintervallet som representeras av timeSpan.

Undantag

ArgumentOutOfRangeException

Det resulterande DateTimeOffset värdet är mindre än DateTimeOffset.MinValue.

-eller-

Det resulterande DateTimeOffset värdet är större än DateTimeOffset.MaxValue.

Exempel

I följande exempel skapas en matris med TimeSpan objekt som representerar flygtiderna mellan mål. Metoden Add lägger sedan till dessa tider i ett DateTimeOffset objekt som representerar en flygresas första starttid. Resultatet visar den schemalagda ankomsttiden vid varje mål.

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

Kommentarer

Du kan använda Add metoden för att lägga till mer än en typ av tidsintervall (dagar, timmar, minuter, sekunder eller millisekunder) i en enda åtgärd. Den här metodens beteende är identiskt med additionsoperatorn. Strukturen DateTimeOffset stöder också specialiserade tilläggsmetoder (till exempel AddDays, AddHoursoch AddMinutes) för varje tidsintervall.

Note

Den här metoden returnerar ett nytt DateTimeOffset objekt. Det ändrar inte värdet för det aktuella objektet genom att lägga timeSpan till dess datum och tid.

Metoden Add påverkar inte värdet för det aktuella DateTimeOffset objektets Offset egenskap.

Eftersom ett DateTimeOffset objekt inte representerar datum och tid i en specifik tidszon tar Add metoden inte hänsyn till en viss tidszons justeringsregler när den utför datum- och tidsaritmetik.

Om parametern timeSpan är nullreturnerar den här metoden värdet för det ursprungliga DateTimeOffset objektet oförändrat.

Gäller för

Se även