DateTimeOffset.AddMonths(Int32) Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

DateTimeOffset.cs

Zwraca nowy DateTimeOffset obiekt, który dodaje określoną liczbę miesięcy do wartości tego wystąpienia.

public:
 DateTimeOffset AddMonths(int months);

public DateTimeOffset AddMonths (int months);

member this.AddMonths : int -> DateTimeOffset

Public Function AddMonths (months As Integer) As DateTimeOffset

Parametry

months

Int32

Liczba całych miesięcy. Liczba może być dodatnia lub ujemna.

Zwraca

DateTimeOffset

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez bieżący DateTimeOffset obiekt oraz liczbę miesięcy reprezentowanych przez obiekt months.

Wyjątki

ArgumentOutOfRangeException

DateTimeOffset Wynikowa wartość jest mniejsza niż DateTimeOffset.MinValue.

-lub-

DateTimeOffset Wynikowa wartość jest większa niż DateTimeOffset.MaxValue.

Przykłady

W poniższym przykładzie użyto AddMonths metody , aby wyświetlić datę rozpoczęcia każdego kwartału roku 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

Uwagi

W przeciwieństwie do większości innych metod, które dodają pojedynczą jednostkę interwału czasu (na przykład minuty lub dni) do wartości daty i godziny, AddMonths nie umożliwiają dodawania części ułamkowych miesiąca. Aby dodać czas składający się z innych jednostek czasu oprócz miesięcy do DateTimeOffset obiektu, użyj Add metody .

Uwaga

Ta metoda zwraca nowy DateTimeOffset obiekt. Nie modyfikuje wartości bieżącego obiektu przez dodanie months jej do daty i godziny.