DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) Method

Definition

Gibt einen neuen DateTime-Wert zurück, der den Wert des angegebenen TimeSpan-Werts zum Wert dieser Instanz addiert.Returns a new DateTime that adds the value of the specified TimeSpan to the value of this instance.

public:
 DateTime Add(TimeSpan value);
public DateTime Add (TimeSpan value);
member this.Add : TimeSpan -> DateTime
Public Function Add (value As TimeSpan) As DateTime

Parameter

value
TimeSpan TimeSpan TimeSpan TimeSpan

Ein positives oder negatives Zeitintervall.A positive or negative time interval.

Gibt zurück

Ein Objekt, dessen Wert die Summe aus der von dieser Instanz dargestellten Datums- und Uhrzeitangabe und dem durch value dargestellten Zeitintervall ist.An object whose value is the sum of the date and time represented by this instance and the time interval represented by value.

Ausnahmen

Der resultierende DateTime-Wert ist kleiner als MinValue oder größer als MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Beispiele

Das folgende Beispiel veranschaulicht die Add Methode.The following example demonstrates the Add method. Ab diesem Zeitpunkt wird der Wochentag berechnet, der 36 Tage (864 Stunden) entspricht.It calculates the day of the week that is 36 days (864 hours) from this moment.

// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 36, 0, 0, 0 );
System::DateTime answer = today.Add( duration );
System::Console::WriteLine( " {0:dddd}", answer );
// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);
' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)

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 mit dem des Additions Operators identisch.This method's behavior is identical to that of the addition operator. Die DateTime Struktur unterstützt auch spezielle Additions Methoden ( AddDaysz. AddHoursb. AddMinutes, und) für jedes Zeitintervall.The DateTime structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

Bei Add der-Methode werden Schaltjahre und die Anzahl der Tage eines Monats beim Durchführen von Datums Arithmetik berücksichtigt.The Add method takes into account leap years and the number of days in a month when performing date arithmetic.

Diese Methode ändert nicht den Wert dieses DateTime.This method does not change the value of this DateTime. Stattdessen wird ein neuer DateTime zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.Instead, it returns a new DateTime whose value is the result of this operation. Die Kind -Eigenschaft der neuen DateTime -Instanz ist identisch mit der-Eigenschaft der aktuellen Instanz.The Kind property of the new DateTime instance is the same as that of the current instance.

Gilt für:

Siehe auch