Sdílet prostřednictvím

DateTime.Add(TimeSpan) Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
DateTime.cs
Zdroj:
DateTime.cs
Zdroj:
DateTime.cs

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

Viz také