DateTimeOffset.AddMonths(Int32) Methode

Definition

Namespace:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von Monaten hinzufügt.

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 Reihe von ganzen Monaten. Die Zahl kann negativ oder positiv sein.

Gibt zurück

DateTimeOffset

Ein Objekt, dessen Wert die Summe des Datums und der Uhrzeit darstellt, dargestellt durch das aktuelle DateTimeOffset Objekt und die Anzahl von Monaten, die durch monthsdargestellt werden.

Ausnahmen

ArgumentOutOfRangeException

Der resultierende DateTimeOffset Wert ist kleiner als DateTimeOffset.MinValue.

-oder-

Der resultierende DateTimeOffset Wert ist größer als DateTimeOffset.MaxValue.

Beispiele

Im folgenden Beispiel wird die AddMonths Methode verwendet, um das Startdatum jedes Quartals des Jahres 2007 anzuzeigen.

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

Hinweise

Im Gegensatz zu den meisten anderen Methoden, die einem Datums- und Uhrzeitwert eine einzelne Zeitintervalleinheit (z. B. Minuten oder Tage) hinzufügen, AddMonths können Sie keine Bruchteile eines Monats hinzufügen. Wenn Sie eine Zeit hinzufügen möchten, die zusätzlich zu Monaten zu einem DateTimeOffset Objekt aus anderen Zeiteinheiten besteht, verwenden Sie die Add Methode.

Note

Diese Methode gibt ein neues DateTimeOffset Objekt zurück. Der Wert des aktuellen Objekts wird durch Hinzufügen months zu Datum und Uhrzeit nicht geändert.

Gilt für: