DateTime.Add(TimeSpan) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

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 saatin toplamı ve tarafından valuetemsil edilen zaman aralığı olan bir nesne.

Özel durumlar

ArgumentOutOfRangeException

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

Ö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.
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ı DateTime ayrıca her zaman aralığı için özel ekleme yöntemlerini (, ve AddMinutesgibiAddDaysAddHours) destekler.

yöntemi, Add tarih aritmetiği gerçekleştirirken artık yılları ve 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 döndürür. Kind Yeni DateTime örneğin özelliği, geçerli örneğin özelliğiyle aynıdır.

Ayrıca bkz.

• TimeSpan
• Add(TimeSpan)
• Tarih ve Saatlerle Aritmetik İşlemler Gerçekleştirme