다음을 통해 공유


DateTimeOffset.AddMonths(Int32) 메서드

정의

지정된 개월 수를 이 인스턴스의 값에 더하는 새 DateTimeOffset 개체를 반환합니다.

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

개월을 나타내는 정수입니다. 숫자는 음수가 될 수도 있고 양수가 될 수도 있습니다.

반환

값이 현재 DateTimeOffset 개체가 나타내는 날짜 및 시간과 months가 나타내는 개월 수의 합계인 개체입니다.

예외

결과 DateTimeOffset 값이 DateTimeOffset.MinValue보다 작습니다.

또는

결과 DateTimeOffset 값이 DateTimeOffset.MaxValue보다 큽니다.

예제

다음 예제에서는 메서드를 AddMonths 사용하여 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
let mutable quarterDate = DateTimeOffset(2007, 1, 1, 0, 0, 0, DateTimeOffset.Now.Offset)
for i = 1 to 4 do
    printfn $"""Quarter {i}: {quarterDate.ToString "MMMM d"}"""
    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 에 단일 시간 간격 단위(예: 분 또는 일)를 추가하는 다른 대부분의 메서드와 달리 에서는 월의 소수 부분을 추가할 수 없습니다. 개체에 월 DateTimeOffset 외에 다른 시간 단위로 구성된 시간을 추가하려면 메서드를 Add 사용합니다.

참고

이 메서드는 새 DateTimeOffset 개체를 반환합니다. 날짜 및 시간에 를 추가하여 months 현재 개체의 값을 수정하지 않습니다.

적용 대상