DateTime.Add(TimeSpan) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
DateTime.cs
Kaynak:
DateTime.cs
Kaynak:
DateTime.cs

Belirtilen TimeSpan değerini bu örneğin değerine ekleyen yeni DateTime bir döndürür.

public:
 DateTime Add(TimeSpan value);
public DateTime Add (TimeSpan value);
member this.Add : TimeSpan -> DateTime
Public Function Add (value As TimeSpan) As DateTime

Parametreler

value
TimeSpan

Pozitif veya negatif bir zaman aralığı.

Döndürülenler

DateTime

Değeri, bu örnekle temsil edilen tarih ve saat ile temsil valueedilen zaman aralığının toplamı olan bir nesne.

Özel durumlar

ArgumentOutOfRangeException

DateTime Sonuçta DateTime.MinValue değerinden küçük veya DateTime.MaxValue değerinden büyük olur.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Add . Bu andan itibaren 36 gün (864 saat) olan haftanın gününü hesaplar.

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

Açıklamalar

Yöntemini kullanarak Add tek bir işlemde birden fazla zaman aralığı (gün, saat, dakika, saniye veya milisaniye) ekleyebilirsiniz. Bu yöntemin davranışı toplama işlecinin davranışıyla aynıdır. Yapı ayrıca DateTime her zaman aralığı için özelleştirilmiş toplama yöntemlerini (, ve AddMinutesgibiAddDaysAddHours) destekler.

yöntemi artık Add yılları ve tarih aritmetiği gerçekleştirirken ay içindeki gün sayısını dikkate alır.

Bu yöntem bu DateTimedeğerini değiştirmez. Bunun yerine değeri bu işlemin sonucu olan yeni DateTime bir değer döndürür. Kind Yeni DateTime örneğin özelliği geçerli örneğinkiyle aynıdır.

Şunlara uygulanır

Ayrıca bkz.