Freigeben über


DateTime.Add-Methode

Addiert den Wert der angegebenen TimeSpan zum Wert dieser Instanz.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function Add ( _
    value As TimeSpan _
) As DateTime
'Usage
Dim instance As DateTime
Dim value As TimeSpan
Dim returnValue As DateTime

returnValue = instance.Add(value)
public DateTime Add (
    TimeSpan value
)
public:
DateTime Add (
    TimeSpan value
)
public DateTime Add (
    TimeSpan value
)
public function Add (
    value : TimeSpan
) : DateTime

Parameter

  • value
    Eine TimeSpan mit dem zu addierenden Zeitintervall.

Rückgabewert

Eine DateTime, deren Wert die Summe aus der von dieser Instanz dargestellten Datums- und Uhrzeitangabe und dem durch value dargestellten Zeitintervall ist.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

Die sich ergebende DateTime ist kleiner als MinValue oder größer als MaxValue.

Hinweise

Diese Methode ändert den Wert dieser DateTime nicht. Stattdessen wird eine neue DateTime zurückgegeben, deren Wert das Ergebnis dieser Operation ist.

Beispiel

Im folgenden Codebeispiel wird die Add-Methode veranschaulicht. Es wird der Wochentag berechnet, der 36 Tage (864 Stunden) nach dem aktuellen Zeitpunkt liegt.

' 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)
// 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.
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.get_Now();
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DateTime-Struktur
DateTime-Member
System-Namespace
TimeSpan
TimeSpan.Add