Freigeben über


DateTime.Add(TimeSpan) Methode

Definition

Gibt einen neuen DateTime-Wert zurück, der den Wert des angegebenen TimeSpan-Werts zum Wert dieser Instanz addiert.

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

Ein positives oder negatives Zeitintervall.

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.

Ausnahmen

Das resultierende DateTime ist kleiner als DateTime.MinValue oder größer als DateTime.MaxValue.

Beispiele

Das folgende Beispiel veranschaulicht die Add Methode. Er berechnet den Wochentag, der 36 Tage (864 Stunden) ab diesem Zeitpunkt beträgt.

// 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.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"
// 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 von Zeitintervall (Tage, Stunden, Minuten, Sekunden oder Millisekunden) in einem einzelnen Vorgang hinzuzufügen. Das Verhalten dieser Methode ist mit dem des Additionsoperators identisch. Die DateTime -Struktur unterstützt auch spezielle Additionsmethoden (z AddDays. B. , AddHoursund AddMinutes) für jedes Zeitintervall.

Die Add Methode berücksichtigt Schaltjahre und die Anzahl der Tage in einem Monat bei der Ausführung der Datumsarithmetik.

Diese Methode ändert nicht den Wert dieses DateTime. Stattdessen wird ein neues DateTime zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist. Die Kind -Eigenschaft des neuen DateTime instance entspricht der der aktuellen instance.

Gilt für:

Weitere Informationen