DateTimeOffset.AddMonths(Int32) Metod

Definition

Namnområde:
System
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs

Returnerar ett nytt DateTimeOffset objekt som lägger till ett angivet antal månader i värdet för den här instansen.

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

Parametrar

months
Int32

Ett antal hela månader. Talet kan vara negativt eller positivt.

Returer

DateTimeOffset

Ett objekt vars värde är summan av datum och tid som representeras av det aktuella DateTimeOffset objektet och antalet månader som representeras av months.

Undantag

ArgumentOutOfRangeException

Det resulterande DateTimeOffset värdet är mindre än DateTimeOffset.MinValue.

-eller-

Det resulterande DateTimeOffset värdet är större än DateTimeOffset.MaxValue.

Exempel

I följande exempel används AddMonths metoden för att visa startdatumet för varje kvartal under året 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

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

Kommentarer

Till skillnad från de flesta andra metoder som lägger till en enskild tidsintervallenhet (till exempel minuter eller dagar) till ett datum- och tidsvärde, AddMonths kan du inte lägga till bråkdelar i en månad. Om du vill lägga till en tid som består av andra tidsenheter utöver månader till ett DateTimeOffset objekt använder du Add metoden .

Note

Den här metoden returnerar ett nytt DateTimeOffset objekt. Det ändrar inte värdet för det aktuella objektet genom att lägga months till dess datum och tid.

Gäller för