DateTime.AddMonths(Int32) DateTime.AddMonths(Int32) DateTime.AddMonths(Int32) DateTime.AddMonths(Int32) Method

정의

지정된 월 수를 이 인스턴스의 값에 더하는 새 DateTime을 반환합니다.Returns a new DateTime that adds the specified number of months to the value of this instance.

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

매개 변수

months
Int32 Int32 Int32 Int32

월 수입니다.A number of months. months 매개 변수는 음수일 수도 있고 양수일 수도 있습니다.The months parameter can be negative or positive.

반환

이 인스턴스가 나타내는 날짜 및 시간과 months가 나타내는 월 수의 합이 값인 개체입니다.An object whose value is the sum of the date and time represented by this instance and months.

예외

결과는 DateTimeMinValue보다 작거나 MaxValue보다 큽니다.The resulting DateTime is less than MinValue or greater than MaxValue.

또는-or- months가 -120,000보다 작거나 120,000보다 큽니다.months is less than -120,000 or greater than 120,000.

예제

다음 예제에서는 2015 년 12 월의 마지막 날에 사이 및 15 개월을 추가합니다.The following example adds between zero and fifteen months to the last day of December, 2015. 이 경우 AddMonths 메서드는 각 월의 마지막 날의 날짜를 반환 하 고 성공적으로 윤년을 처리 합니다.In this case, the AddMonths method returns the date of the last day of each month, and successfully handles leap years.

using System;

public class Example
{
   public static void Main()
   {
      var dat = new DateTime(2015, 12, 31);
      for (int ctr = 0; ctr <= 15; ctr++)
         Console.WriteLine(dat.AddMonths(ctr).ToString("d"));

   }
}
// The example displays the following output:
//       12/31/2015
//       1/31/2016
//       2/29/2016
//       3/31/2016
//       4/30/2016
//       5/31/2016
//       6/30/2016
//       7/31/2016
//       8/31/2016
//       9/30/2016
//       10/31/2016
//       11/30/2016
//       12/31/2016
//       1/31/2017
//       2/28/2017
//       3/31/2017
Module Example
   Public Sub Main()
      Dim dat As Date = #12/31/2015#
      For ctr As Integer = 0 To 15
         Console.WriteLine(dat.AddMonths(ctr).ToString("d"))
      Next
   End Sub
End Module
' The example displays the following output:
'       12/31/2015
'       1/31/2016
'       2/29/2016
'       3/31/2016
'       4/30/2016
'       5/31/2016
'       6/30/2016
'       7/31/2016
'       8/31/2016
'       9/30/2016
'       10/31/2016
'       11/30/2016
'       12/31/2016
'       1/31/2017
'       2/28/2017
'       3/31/2017

설명

이 메서드는이 값을 변경 하지 않습니다 DateTime 개체입니다.This method does not change the value of this DateTime object. 대신에 새 반환 DateTime 값인이 작업의 결과 개체입니다.Instead, it returns a new DateTime object whose value is the result of this operation.

합니다 AddMonths 메서드는 결과 월을 계산 하 고 계정 윤년 및 월의 일 수를 고려 하는 연도, 그런 다음 결과의 일 부분을 조정 DateTime 개체입니다.The AddMonths method calculates the resulting month and year, taking into account leap years and the number of days in a month, then adjusts the day part of the resulting DateTime object. 결과 일 월에 유효한 날짜가 없으면 결과 월의 마지막 유효 날짜가 사용 됩니다.If the resulting day is not a valid day in the resulting month, the last valid day of the resulting month is used. 예제에서는 3 월 31 + 1 개월 = 4 월 30 일 및 3 월 31-1 월 = 2 월 28 일에 대 한 비-윤년 및 윤년에 대 한 2 월 29입니다.For example, March 31st + 1 month = April 30th, and March 31st - 1 month = February 28 for a non-leap year and February 29 for a leap year.

결과 시간 부분은 DateTime 개체가이 인스턴스와 동일 하 게 유지 합니다.The time-of-day part of the resulting DateTime object remains the same as this instance.

적용 대상