DateTime.Add(TimeSpan) Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

DateTime.cs

Egy új DateTime értéket ad vissza, amely hozzáadja a megadott TimeSpan értéket a példány értékéhez.

public:
 DateTime Add(TimeSpan value);

public DateTime Add(TimeSpan value);

member this.Add : TimeSpan -> DateTime

Public Function Add (value As TimeSpan) As DateTime

Paraméterek

value

TimeSpan

Pozitív vagy negatív időintervallum.

Válaszok

DateTime

Olyan objektum, amelynek értéke a példány által képviselt dátum és idő összege, valamint az általuk valueképviselt időintervallum.

Kivételek

ArgumentOutOfRangeException

Az eredmény DateTime kisebb, mint a DateTime.MinValue vagy nagyobb , mint a DateTime.MaxValue.

Példák

Az alábbi példa a metódust Add mutatja be. Kiszámítja a hét napját, amely 36 nap (864 óra) ettől a pillanattól kezdve.

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

Megjegyzések

A metódussal Add több időintervallumot (nap, óra, perc, másodperc vagy ezredmásodperc) adhat hozzá egyetlen művelethez. Ez a metódus viselkedése megegyezik az összeadási operátoréval. A DateTime struktúra emellett támogatja a speciális összeadási módszereket (például AddDays, AddHoursés AddMinutes) minden egyes időintervallumhoz.

A Add módszer figyelembe veszi a szökőéveket és az egy hónap napjainak számát a dátum-aritmetika végrehajtásakor.

Ez a metódus nem módosítja ennek DateTimeaz értéknek az értékét. Ehelyett egy újat DateTime ad vissza, amelynek az értéke ennek a műveletnek az eredménye. Az Kind új DateTime példány tulajdonsága megegyezik az aktuális példány tulajdonságával.

Lásd még

• TimeSpan
• Add(TimeSpan)
• Aritmetikai műveletek végrehajtása dátumokkal és időpontokkal