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      

설명

날짜 및 시간 값에 단일 시간 간격 단위 (예: 분 또는 일)를 추가 하는 다른 메서드와 달리 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.

적용 대상