DateTimeOffset.AddMonths(Int32) メソッド

定義

このインスタンスの値に、指定された月数を加算した新しい DateTimeOffset オブジェクトを返します。Returns a new DateTimeOffset object that adds a specified number of months to the value of this instance.

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

整数の月数。A number of whole months. 正数または負数を指定できます。The number can be negative or positive.

戻り値

現在の DateTimeOffset オブジェクトで表された日時に months で表された月数を加算した値を示すオブジェクト。An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of months represented by months.

例外

結果として得られる DateTimeOffset 値は MinValue より小さい値です。The resulting DateTimeOffset value is less than MinValue.

- または --or- 結果として得られる DateTimeOffset 値が MaxValue を超えています。The resulting DateTimeOffset value is greater than MaxValue.

次の例では、AddMonths メソッドを使用して、2007年の各四半期の開始日を表示します。The following example uses the AddMonths method to display the start date of each quarter of the year 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      
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 では、月の小数部を追加することはできません。Unlike most of the other methods that add a single time interval unit (such as minutes or days) to a date and time value, AddMonths does not enable you to add fractional parts of a month. DateTimeOffset のオブジェクトに対して他の時間単位で構成される時間を追加するには、Add メソッドを使用します。To add a time that consists of other time units in addition to months to a DateTimeOffset object, use the Add method.

注意

このメソッドは、新しい DateTimeOffset オブジェクトを返します。This method returns a new DateTimeOffset object. 日付と時刻に months を追加することによって、現在のオブジェクトの値を変更することはありません。It does not modify the value of the current object by adding months to its date and time.

適用対象