DateTimeOffset.Add(TimeSpan) Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs

Gibt ein neues DateTimeOffset-Objekt zurück, das ein angegebenes Zeitintervall zum Wert dieser Instanz addiert.

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

Parameter

timeSpan
TimeSpan

Ein TimeSpan-Objekt, das ein positives oder ein negatives Zeitintervall darstellt.

Gibt zurück

DateTimeOffset

Ein Objekt, dessen Wert die Summe aus der vom aktuellen DateTimeOffset -Objekt dargestellten Datums- und Uhrzeitangabe und dem durch timeSpan dargestellten Zeitintervall ist.

Ausnahmen

ArgumentOutOfRangeException

Der resultierende DateTimeOffset Wert ist kleiner als DateTimeOffset.MinValue.

- oder -

Der resultierende DateTimeOffset Wert ist größer als DateTimeOffset.MaxValue.

Beispiele

Im folgenden Beispiel wird ein Array von TimeSpan -Objekten erstellt, die die Flugzeiten zwischen Zielen darstellen. Die Add -Methode fügt diese Zeiten dann einem DateTimeOffset -Objekt hinzu, das die anfängliche Startzeit eines Flugs darstellt. Das Ergebnis spiegelt die geplante Ankunftszeit an jedem Ziel wider.

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

Hinweise

Sie können die Add -Methode verwenden, um mehr als eine Art von Zeitintervall (Tage, Stunden, Minuten, Sekunden oder Millisekunden) in einem einzelnen Vorgang hinzuzufügen. Das Verhalten dieser Methode ist identisch mit dem Additionsoperator. Die DateTimeOffset -Struktur unterstützt auch spezielle Additionsmethoden (z AddDays. B. , AddHoursund AddMinutes) für jedes Zeitintervall.

Hinweis

Diese Methode gibt ein neues DateTimeOffset -Objekt zurück. Der Wert des aktuellen Objekts wird nicht durch Hinzufügen timeSpan von Datum und Uhrzeit geändert.

Die Add -Methode wirkt sich nicht auf den Wert der -Eigenschaft des aktuellen DateTimeOffset Objekts aus Offset .

Da ein DateTimeOffset -Objekt das Datum und die Uhrzeit in einer bestimmten Zeitzone nicht darstellt, berücksichtigt die Add Methode beim Ausführen der Datums- und Uhrzeitarithmetik nicht die Anpassungsregeln einer bestimmten Zeitzone.

Wenn der timeSpan Parameter ist null, gibt diese Methode den Wert des ursprünglichen DateTimeOffset Objekts unverändert zurück.

Gilt für:

Weitere Informationen