DateTime.AddMonths(Int32) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

DateTime.cs

Belirtilen ay sayısını bu örneğin değerine ekleyen yeni DateTime bir değer döndürür.

public:
 DateTime AddMonths(int months);

public DateTime AddMonths (int months);

member this.AddMonths : int -> DateTime

Public Function AddMonths (months As Integer) As DateTime

Parametreler

months

Int32

Birkaç ay. months Parametre negatif veya pozitif olabilir.

Döndürülenler

DateTime

Değeri, bu örnek ve monthsile temsil edilen tarih ve saatin 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.

-veya-

months -120.000'den küçük veya 120.000'den büyük.

Örnekler

Aşağıdaki örnek, Aralık 2015'in son gününe sıfır ile on beş ay arasında ekler. Bu durumda, AddMonths yöntemi her ayın son gününün tarihini döndürür ve artık yılları başarıyla işler.

using System;

public class Example
{
   public static void Main()
   {
      var dat = new DateTime(2015, 12, 31);
      for (int ctr = 0; ctr <= 15; ctr++)
         Console.WriteLine(dat.AddMonths(ctr).ToString("d"));
   }
}
// The example displays the following output:
//       12/31/2015
//       1/31/2016
//       2/29/2016
//       3/31/2016
//       4/30/2016
//       5/31/2016
//       6/30/2016
//       7/31/2016
//       8/31/2016
//       9/30/2016
//       10/31/2016
//       11/30/2016
//       12/31/2016
//       1/31/2017
//       2/28/2017
//       3/31/2017

open System

let dat = DateTime(2015, 12, 31)
for i = 0 to 15 do
    printfn $"{dat.AddMonths i:d}"

// The example displays the following output:
//       12/31/2015
//       1/31/2016
//       2/29/2016
//       3/31/2016
//       4/30/2016
//       5/31/2016
//       6/30/2016
//       7/31/2016
//       8/31/2016
//       9/30/2016
//       10/31/2016
//       11/30/2016
//       12/31/2016
//       1/31/2017
//       2/28/2017
//       3/31/2017

Module Example
   Public Sub Main()
      Dim dat As Date = #12/31/2015#
      For ctr As Integer = 0 To 15
         Console.WriteLine(dat.AddMonths(ctr).ToString("d"))
      Next
   End Sub
End Module
' The example displays the following output:
'       12/31/2015
'       1/31/2016
'       2/29/2016
'       3/31/2016
'       4/30/2016
'       5/31/2016
'       6/30/2016
'       7/31/2016
'       8/31/2016
'       9/30/2016
'       10/31/2016
'       11/30/2016
'       12/31/2016
'       1/31/2017
'       2/28/2017
'       3/31/2017

Açıklamalar

Bu yöntem bu DateTime nesnenin değerini değiştirmez. Bunun yerine, değeri bu işlemin sonucu olan yeni DateTime bir nesne döndürür.

AddMonths yöntemi, artık yılları ve bir aydaki gün sayısını dikkate alarak sonuçta elde edilen ayı ve yılı hesaplar, ardından sonuçta DateTime elde edilen nesnenin gün bölümünü ayarlar. Sonuçta elde edilen gün, sonuçta elde edilen ayda geçerli bir gün değilse, sonuçta elde edilen ayın son geçerli günü kullanılır. Örneğin, artık olmayan bir yıl için 31 Mart + 1 ay = 30 Nisan ve 31 Mart - 1 ay = 28 Şubat ve artık yıl için 29 Şubat.

Sonuçta elde DateTime edilen nesnenin günün saati bölümü bu örnekle aynı kalır.