DateTimeOffset.AddMonths(Int32) Methode

Definition

Gibt ein neues DateTimeOffset-Objekt zurück, das eine angegebene Anzahl von Monaten zum Wert dieser Instanz addiert.Returns a new DateTimeOffset object that adds a specified number of months to the value of this instance.

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

Parameter

months
Int32

Eine Anzahl von ganzen Monaten.A number of whole months. Die Zahl kann negativ oder positiv sein.The number can be negative or positive.

Gibt zurück

Ein Objekt, dessen Wert die Summe aus der vom aktuellen DateTimeOffset-Objekt dargestellten Datums- und Uhrzeitangabe und der von months dargestellten Anzahl von Monaten ist.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of months represented by months.

Ausnahmen

Der resultierende DateTimeOffset-Wert ist kleiner als MinValue.The resulting DateTimeOffset value is less than MinValue.

- oder --or- Der sich ergebende DateTimeOffset-Wert ist größer als MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Beispiele

Im folgenden Beispiel wird die AddMonths-Methode verwendet, um das Startdatum jedes Quartals des Jahres 2007 anzuzeigen.The following example uses the AddMonths method to display the start date of each quarter of the year 2007.

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

Hinweise

Anders als bei den meisten anderen Methoden, die einem Datums-und Uhrzeitwert eine einzelne Zeitintervall Einheit (z. b. Minuten oder Tage) hinzufügen, können AddMonths keine Bruchteile eines Monats hinzufügen.Unlike most of the other methods that add a single time interval unit (such as minutes or days) to a date and time value, AddMonths does not enable you to add fractional parts of a month. Verwenden Sie die Add-Methode, um eine Zeit hinzuzufügen, die zusätzlich zu den Monaten für ein DateTimeOffset Objekt aus anderen Zeiteinheiten besteht.To add a time that consists of other time units in addition to months to a DateTimeOffset object, use the Add method.

Hinweis

Diese Methode gibt ein neues DateTimeOffset-Objekt zurück.This method returns a new DateTimeOffset object. Der Wert des aktuellen-Objekts wird nicht geändert, indem dem Datum und der Uhrzeit months hinzugefügt wird.It does not modify the value of the current object by adding months to its date and time.

Gilt für: