DateTime.AddMonths(Int32) Methode

Definition

Gibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl von Monaten zum Wert dieser Instanz addiert.Returns a new DateTime that adds the specified number of months to the value of this instance.

public:
 DateTime AddMonths(int months);
public DateTime AddMonths (int months);
member this.AddMonths : int -> DateTime
Public Function AddMonths (months As Integer) As DateTime

Parameter

months
Int32

Eine Anzahl von Monaten.A number of months. Der months-Parameter kann negativ oder positiv sein.The months parameter can be negative or positive.

Gibt zurück

Ein Objekt, dessen Wert die Summe aus der von dieser Instanz dargestellten Datums- und Uhrzeitangabe und months ist.An object whose value is the sum of the date and time represented by this instance and months.

Ausnahmen

Der resultierende DateTime-Wert ist kleiner als MinValue oder größer als MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

- oder --or- months ist kleiner als –120.000 oder größer als 120.000.months is less than -120,000 or greater than 120,000.

Beispiele

Im folgenden Beispiel wird der letzte Tag des Dezember 2015 zwischen 0 und 15 Monaten hinzugefügt.The following example adds between zero and fifteen months to the last day of December, 2015. In diesem Fall gibt die addmonth-Methode das Datum des letzten Tags jedes Monats zurück und verarbeitet die Schaltjahre erfolgreich.In this case, the AddMonths method returns the date of the last day of each month, and successfully handles leap years.

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

Hinweise

Diese Methode ändert nicht den Wert dieses DateTime-Objekts.This method does not change the value of this DateTime object. Stattdessen wird ein neues DateTime-Objekt zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.Instead, it returns a new DateTime object whose value is the result of this operation.

Die AddMonths-Methode berechnet den resultierenden Monat und das Jahr unter Berücksichtigung von Schaltjahren und der Anzahl von Tagen in einem Monat und passt dann den Tages Teil des resultierenden DateTime-Objekts an.The AddMonths method calculates the resulting month and year, taking into account leap years and the number of days in a month, then adjusts the day part of the resulting DateTime object. Wenn der resultierende Tag kein gültiger Tag im resultierenden Monat ist, wird der letzte gültige Tag des resultierenden Monats verwendet.If the resulting day is not a valid day in the resulting month, the last valid day of the resulting month is used. Beispiel: 31. März + 1 Monat = 30. April und 31. März-1 Monat = 21. Februar für ein nicht-Schaltjahr und 29. Februar für ein Schaltjahr.For example, March 31st + 1 month = April 30th, and March 31st - 1 month = February 28 for a non-leap year and February 29 for a leap year.

Der Tageszeit-Teil des resultierenden DateTime-Objekts bleibt unverändert.The time-of-day part of the resulting DateTime object remains the same as this instance.

Gilt für: