DateTime.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.
public:
DateTime Add(TimeSpan value);public DateTime Add(TimeSpan value);member this.Add : TimeSpan -> DateTimePublic Function Add (value As TimeSpan) As DateTimeParameter
- value
- TimeSpan
Ein positives oder negatives Zeitintervall.
Gibt zurück
Ein Objekt, dessen Wert die Summe des durch diese Instanz dargestellten Datums- und Uhrzeitdatums und des durch dargestellten valueZeitintervalls darstellt.
Ausnahmen
Das Ergebnis DateTime ist kleiner als DateTime.MinValue oder größer als DateTime.MaxValue.
Beispiele
Im folgenden Beispiel wird die Add Methode veranschaulicht. Es berechnet den Wochentag, der 36 Tage (864 Stunden) aus diesem Moment beträgt.
// 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
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 des Additionsoperators. 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 beim Ausführen von Datumsarithmetik.
Diese Methode ändert den Wert dieser DateTimeMethode nicht. Stattdessen wird ein neuer DateTime Wert zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist. Die Kind Eigenschaft der neuen DateTime Instanz ist identisch mit der der aktuellen Instanz.
