DateTimeOffset.AddMonths(Int32) DateTimeOffset.AddMonths(Int32) DateTimeOffset.AddMonths(Int32) DateTimeOffset.AddMonths(Int32) Method


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

 DateTimeOffset AddMonths(int months);
public DateTimeOffset AddMonths (int months);
member this.AddMonths : int -> DateTimeOffset
Public Function AddMonths (months As Integer) As DateTimeOffset


Int32 Int32 Int32 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, 
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)
' This example produces the following output:
'       Quarter 1: January 1
'       Quarter 2: April 1
'       Quarter 3: July 1
'       Quarter 4: October 1      


ほとんどの日付と時刻の値に、1 つの時間間隔の単位 (分単位、日など) を追加するその他のメソッドとは異なりAddMonths1 か月の部分の小数部を追加することを有効にしません。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.