DateTime.Add(TimeSpan) Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Source:: DateTime.cs

Source:: DateTime.cs

Source:: DateTime.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí nový DateTime , který přidá hodnotu zadané TimeSpan k hodnotě této instance.

public:
 DateTime Add(TimeSpan value);

public DateTime Add (TimeSpan value);

member this.Add : TimeSpan -> DateTime

Public Function Add (value As TimeSpan) As DateTime

Parametry

value: TimeSpan

Kladný nebo záporný časový interval.

Návraty

DateTime

Objekt, jehož hodnota je součet data a času reprezentovaných touto instancí a časový interval reprezentovaný hodnotou value.

Výjimky

ArgumentOutOfRangeException

Výsledná hodnota DateTime je menší než DateTime.MinValue nebo větší než DateTime.MaxValue.

Příklady

Následující příklad ukazuje metodu Add . Vypočítá den v týdnu, který je od tohoto okamžiku 36 dní (864 hodin).

// 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)

Poznámky

Pomocí metody můžete Add v rámci jedné operace přidat více než jeden druh časového intervalu (dny, hodiny, minuty, sekundy nebo milisekundy). Chování této metody je stejné jako chování operátoru sčítání. Struktura DateTime také podporuje specializované metody sčítání (například AddDays, AddHoursa AddMinutes) pro každý časový interval.

Metoda Add při provádění aritmetické operace kalendářních dat bere v úvahu přestupné roky a počet dní v měsíci.

Tato metoda nezmění hodnotu této DateTimemetody . Místo toho vrátí novou DateTime hodnotu, jejíž hodnota je výsledkem této operace. Vlastnost Kind nové DateTime instance je stejná jako vlastnost aktuální instance.

Platí pro