DateTimeOffset.Add(TimeSpan) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> DateTimeOffsetPublic Function Add (timeSpan As TimeSpan) As DateTimeOffsetParameter
- timeSpan
- TimeSpan
Ein TimeSpan-Objekt, das ein positives oder ein negatives Zeitintervall darstellt.
Gibt zurück
Ein Objekt, dessen Wert die Summe aus der vom aktuellen DateTimeOffset -Objekt dargestellten Datums- und Uhrzeitangabe und dem durch timeSpan dargestellten Zeitintervall ist.
Ausnahmen
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.
