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 dem Wert dieser Instanz ein angegebenes Zeitintervall hinzufügt.
public:
DateTimeOffset Add(TimeSpan timeSpan);public DateTimeOffset Add(TimeSpan timeSpan);member this.Add : TimeSpan -> DateTimeOffsetPublic Function Add (timeSpan As TimeSpan) As DateTimeOffsetParameter
Gibt zurück
Ein Objekt, dessen Wert die Summe des Datums und der Uhrzeit darstellt, dargestellt durch das aktuelle DateTimeOffset Objekt und das durch timeSpan.
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 zu einem DateTimeOffset Objekt hinzu, das die anfängliche Startzeit eines Test-Flight 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
Mit der Add Methode können Sie einem einzelnen Vorgang mehrere Arten von Zeitintervallen (Tage, Stunden, Minuten, Sekunden oder Millisekunden) hinzufü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 durch Hinzufügen timeSpan zu Datum und Uhrzeit nicht geändert.
Die Add Methode wirkt sich nicht auf den Wert der Eigenschaft des aktuellen DateTimeOffset Objekts Offset aus.
Da ein DateTimeOffset Objekt das Datum und die Uhrzeit in einer bestimmten Zeitzone nicht darstellt, berücksichtigt die Add Methode bei der Ausführung von Datums- und Uhrzeitarithmetik keine Anpassungsregeln einer bestimmten Zeitzone.
Wenn der timeSpan Parameter lautet null, gibt diese Methode den Wert des ursprünglichen DateTimeOffset Objekts unverändert zurück.
