DateTimeOffset.AddMonths(Int32) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

DateTimeOffset.cs

傳回新的 DateTimeOffset 物件，將這個執行個體的值加上指定的月數。

public:
 DateTimeOffset AddMonths(int months);

public DateTimeOffset AddMonths (int months);

member this.AddMonths : int -> DateTimeOffset

Public Function AddMonths (months As Integer) As DateTimeOffset

參數

months

Int32

整數月份數。 可以是負數或正數。

傳回

DateTimeOffset

物件，其值為目前 DateTimeOffset 物件所表示之日期和時間加上 months 所表示之月份數的總和。

例外狀況

ArgumentOutOfRangeException

產生的 DateTimeOffset 值小於 DateTimeOffset.MinValue。

-或-

產生的 DateTimeOffset 值大於 DateTimeOffset.MaxValue。

範例

下列範例會 AddMonths 使用 方法來顯示 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

備註

不同于新增單一時間間隔單位 (的大多數其他方法，例如分鐘數或天數) 到日期和時間值， AddMonths 並不會讓您新增月份的小數部分。 若要在 物件中新增包含其他時間單位的時間，除了數個月之外 DateTimeOffset ，請使用 Add 方法。

注意

這個方法會傳回新的 DateTimeOffset 物件。 它不會藉由新增 months 至目前物件的日期和時間來修改其值。