DateTimeOffset.AddMonths(Int32) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

DateTimeOffset.cs

Bu örneğin değerine belirtilen sayıda ay ekleyen yeni DateTimeOffset bir nesne döndürür.

public:
 DateTimeOffset AddMonths(int months);

public DateTimeOffset AddMonths (int months);

member this.AddMonths : int -> DateTimeOffset

Public Function AddMonths (months As Integer) As DateTimeOffset

Parametreler

months

Int32

Bir dizi tam ay. 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 monthsedilen ay 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, 2007 yılının her üç aylık döneminin başlangıç tarihini görüntülemek için yöntemini kullanır AddMonths .

DateTimeOffset quarterDate = new DateTimeOffset(2007, 1, 1, 0, 0, 0,
                                 DateTimeOffset.Now.Offset);
for (int ctr = 1; ctr <= 4; ctr++)
{
   Console.WriteLine("Quarter {0}: {1:MMMM d}", ctr, quarterDate);
   quarterDate = quarterDate.AddMonths(3);
}
// This example produces the following output:
//       Quarter 1: January 1
//       Quarter 2: April 1
//       Quarter 3: July 1
//       Quarter 4: October 1

let mutable quarterDate = DateTimeOffset(2007, 1, 1, 0, 0, 0, DateTimeOffset.Now.Offset)
for i = 1 to 4 do
    printfn $"""Quarter {i}: {quarterDate.ToString "MMMM d"}"""
    quarterDate <- quarterDate.AddMonths 3

// This example produces the following output:
//       Quarter 1: January 1
//       Quarter 2: April 1
//       Quarter 3: July 1
//       Quarter 4: October 1

Dim quarterDate As New DateTimeOffset(#01/01/2007#, DateTimeOffset.Now.Offset)
For ctr As Integer = 1 To 4
   Console.WriteLine("Quarter {0}: {1:MMMM d}", ctr, quarterDate)
   quarterDate = quarterDate.AddMonths(3)
Next   
' This example produces the following output:
'       Quarter 1: January 1
'       Quarter 2: April 1
'       Quarter 3: July 1
'       Quarter 4: October 1

Açıklamalar

Tarih ve saat değerine tek bir zaman aralığı birimi (dakika veya gün gibi) ekleyen diğer yöntemlerin çoğundan farklı olarak, AddMonths ayın kesirli bölümlerini eklemenize olanak tanımaz. Bir nesneye aylara ek olarak diğer zaman birimlerinden oluşan bir DateTimeOffset zaman eklemek için yöntemini kullanın Add .

Not

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