DateTimeOffset.AddMonths(Int32) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

DateTimeOffset.cs

このインスタンスの値に、指定された月数を加算した新しい DateTimeOffset オブジェクトを返します。

C#

public DateTimeOffset AddMonths(int months);

パラメーター

months

Int32

整数の月数。 正数または負数を指定できます。

戻り値

DateTimeOffset

現在の DateTimeOffset オブジェクトで表された日時に months で表された月数を加算した値を示すオブジェクト。

例外

ArgumentOutOfRangeException

結果 DateTimeOffset の値が DateTimeOffset.MinValue 未満です。

\- または -

結果 DateTimeOffset の値が DateTimeOffset.MaxValue より大きくなります。

例

次の例では、 メソッドを AddMonths 使用して、2007 年の各四半期の開始日を表示します。

C#

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

注釈

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

注意

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

適用対象