DateTimeOffset.AddDays(Double) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

DateTimeOffset.cs

Bu örneğin değerine belirtilen sayıda tam ve kesirli gün ekleyen yeni DateTimeOffset bir nesne döndürür.

public DateTimeOffset AddDays(double days);

Parametreler

days

Double

Tam ve kesirli gün sayısı. Sayı negatif veya pozitif olabilir.

Döndürülenler

DateTimeOffset

Değeri geçerli DateTimeOffset nesneyle temsil edilen tarih ve saatin toplamı ve ile temsil edilen daysgün sayısı olan bir nesne.

Özel durumlar

ArgumentOutOfRangeException

Sonuçta elde edilen DateTimeOffset değer DateTimeOffset.MinValue değerinden küçüktür.

-veya-

Sonuçta elde edilen DateTimeOffset değer DateTimeOffset.MaxValue değerinden büyüktür.

Örnekler

Aşağıdaki örnek, Mart 2008'de çalışma haftasının başlangıcı olan Pazartesi gününe denk gelen tarihleri listelemek için yöntemini kullanır AddDays .

DateTimeOffset workDay = new DateTimeOffset(2008, 3, 1, 9, 0, 0,
                   DateTimeOffset.Now.Offset);
int month = workDay.Month;
// Start with the first Monday of the month
if (workDay.DayOfWeek != DayOfWeek.Monday)
{
   if (workDay.DayOfWeek == DayOfWeek.Sunday)
      workDay = workDay.AddDays(1);
   else
      workDay = workDay.AddDays(8 - (int)workDay.DayOfWeek);
}
Console.WriteLine("Beginning of Work Week In {0:MMMM} {0:yyyy}:", workDay);
// Add one week to the current date
do
{
   Console.WriteLine("   {0:dddd}, {0:MMMM}{0: d}", workDay);
   workDay = workDay.AddDays(7);
} while (workDay.Month == month);
// The example produces the following output:
//    Beginning of Work Week In March 2008:
//       Monday, March 3
//       Monday, March 10
//       Monday, March 17
//       Monday, March 24
//       Monday, March 31

Açıklamalar

Parametrenin days kesirli bölümü, günün kesirli bölümüdür. Örneğin, 4,5 4 gün, 12 saat, 0 dakika, 0 saniye, 0 milisaniye ile eşdeğerdir.

.NET 6 ve önceki sürümlerde days parametresi en yakın milisaniyeye yuvarlanmıştır. .NET 7 ve sonraki sürümlerde parametresinin days tam Double duyarlığı kullanılır. Ancak, kayan nokta matematiğin doğal kararsızlığı nedeniyle elde edilen duyarlık farklılık gösterir.

Not

Bu yöntem yeni DateTimeOffset bir nesne döndürür. Geçerli nesnenin değerini tarih ve saatine ekleyerek days değiştirmez.

Bir nesne belirli bir DateTimeOffset saat dilimindeki tarih ve saati temsil etmediğinden, AddDays yöntem tarih ve saat aritmetiği gerçekleştirirken belirli bir saat diliminin ayarlama kurallarını dikkate almaz.

Bir günden küçük zaman aralıklarının kesire dönüştürülmesi duyarlık kaybına neden olabilir. Bu sorunluysa, tek bir yöntem çağrısında Add birden fazla tür zaman aralığı belirtmenize olanak tanıyan ve zaman aralıklarını günün kesirli bölümlerine dönüştürme gereksinimini ortadan kaldıran yöntemini kullanabilirsiniz.

Şunlara uygulanır