DateTimeOffset.AddMonths(Int32) メソッド

定義

このインスタンスの値に、指定された月数を加算した新しい 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 で表された月数を加算した値を示すオブジェクト。

例外

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

注釈

日付と時刻の値に 1 つの時間間隔単位 (分や日など) を追加する他のほとんどの方法とは異なり、 AddMonths 月の小数部を追加することはできません。 月に加えて他の時間単位で構成される時刻をオブジェクトに DateTimeOffset 追加するには、 メソッドを Add 使用します。

Note

このメソッドは、新 DateTimeOffset しい オブジェクトを返します。 現在のオブジェクトの日付と時刻に を追加 months しても、現在のオブジェクトの値は変更されません。

適用対象