DateTime.Add(TimeSpan) Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

DateTime.cs

Vrátí novou DateTime hodnotu, která přidá hodnotu zadanou 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é touto instancí a časový interval reprezentovaný value.

Výjimky

ArgumentOutOfRangeException

Výsledek 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.
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

Metodu Add můžete použít k přidání více než jednoho druhu časového intervalu (dny, hodiny, minuty, sekundy nebo milisekundy) v jedné operaci. Chování této metody je stejné jako u 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 bere v úvahu přestupné roky a počet dní v měsíci při provádění aritmetiky kalendářního data.

Tato metoda nemění hodnotu tohoto DateTime. 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.

Viz také

• TimeSpan
• Add(TimeSpan)
• Provádění aritmetických operací s daty a časy