DateTimeOffset.Add(TimeSpan) Methode

Definition

Gibt ein neues DateTimeOffset-Objekt zurück, das ein angegebenes Zeitintervall zum Wert dieser Instanz addiert.Returns a new DateTimeOffset object that adds a specified time interval to the value of this instance.

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

Parameter

timeSpan
TimeSpan

Ein TimeSpan-Objekt, das ein positives oder ein negatives Zeitintervall darstellt.A TimeSpan object that represents a positive or a negative time interval.

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.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the time interval represented by timeSpan.

Ausnahmen

Der resultierende DateTimeOffset-Wert ist kleiner als MinValue.The resulting DateTimeOffset value is less than MinValue.

- oder --or- Der resultierende DateTimeOffset-Wert ist größer als MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Beispiele

Im folgenden Beispiel wird ein Array von TimeSpan -Objekten erstellt, die die Flugzeiten zwischen Zielen darstellen.The following example creates an array of TimeSpan objects that represent the flight times between destinations. Die Add -Methode fügt diese Zeiten dann einem DateTimeOffset -Objekt hinzu, das die anfängliche Endzeit des Flugs darstellt.The Add method then adds these times to a DateTimeOffset object that represents a flight's initial takeoff time. Das Ergebnis spiegelt die geplante Ankunftszeit an jedem Ziel wider.The result reflects the scheduled arrival time at each destination.

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);
}
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 Zeitintervall (Tage, Stunden, Minuten, Sekunden oder Millisekunden) in einem einzigen Vorgang hinzuzufügen.You can use the Add method to add more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. Das Verhalten dieser Methode ist identisch mit dem Additions Operator.This method's behavior is identical to the addition operator. Die DateTimeOffset Struktur unterstützt auch spezielle Additions Methoden ( AddDaysz. AddHoursb. AddMinutes, und) für jedes Zeitintervall.The DateTimeOffset structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

Hinweis

Diese Methode gibt ein neues DateTimeOffset -Objekt zurück.This method returns a new DateTimeOffset object. Der Wert des aktuellen-Objekts wird durch Hinzufügen timeSpan zu Datum und Uhrzeit nicht geändert.It does not modify the value of the current object by adding timeSpan to its date and time.

Die Add -Methode wirkt sich nicht auf den Wert der DateTimeOffset - Offset Eigenschaft des aktuellen-Objekts aus.The Add method does not affect the value of the current DateTimeOffset object's Offset property.

Da ein DateTimeOffset -Objekt das Datum und die Uhrzeit in einer bestimmten Zeitzone nicht darstellt, berücksichtigt Add die Methode beim Ausführen von Datums-und Uhrzeit Arithmetik nicht die Anpassungsregeln einer bestimmten Zeitzone.Because a DateTimeOffset object does not represent the date and time in a specific time zone, the Add method does not consider a particular time zone's adjustment rules when it performs date and time arithmetic.

Wenn der timeSpan -Parameter nullist, gibt diese Methode den Wert des ursprünglichen DateTimeOffset -Objekts unverändert zurück.If the timeSpan parameter is null, this method returns the value of the original DateTimeOffset object unchanged.

Gilt für:

Siehe auch