DateTime.AddYears(Int32) 메서드

정의

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

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

매개 변수

value
Int32

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

반환

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

예외

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

설명

이 메서드는이 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.

AddYears 메서드는 윤년을 고려 하 여 결과 연도를 계산 합니다.The AddYears method calculates the resulting year taking into account leap years. 결과 DateTime 개체의 월 및 시간 부분은이 인스턴스와 동일 하 게 유지 됩니다.The month and time-of-day part of the resulting DateTime object remains the same as this instance.

현재 인스턴스가 나타내는 윤년 윤 일 경우 반환 값은 대상 날짜에 따라 달라 집니다.If the current instance represents the leap day in a leap year, the return value depends on the target date:

  • value + DateTime.Year 윤년 인 경우 반환 값은 해당 연도의 윤 일을 나타냅니다.If value + DateTime.Year is also a leap year, the return value represents the leap day in that year. 예를 들어, 4 년 2012 년 2 월 29 일에 추가 되 면 반환 된 날짜는 2016 년 2 월 29 일입니다.For example, if four years is added to February 29, 2012, the date returned is February 29, 2016.

  • value + DateTime.Year 윤년이 아닌 경우 반환 값은 해당 연도의 윤 일 이전 날짜를 나타냅니다.If value + DateTime.Year is not a leap year, the return value represents the day before the leap day in that year. 예를 들어, 2012 년 2 월 29 일, 1 년 동안 추가 된 경우 반환 되는 날짜 2013 년 2 월 28입니다.For example, if one year is added to February 29, 2012, the date returned is February 28, 2013.

다음 예에서는 윤년 일을 나타내는 DateTime 값과 함께 AddYears 메서드를 사용 하는 방법을 보여 줍니다.The following example illustrates using the AddYears method with a DateTime value that represents a leap year day. 15 년 이전 및 다음에 나오는 15 년에 대 한 날짜가 표시 2000 년 2 월 29 일입니다.It displays the date for the fifteen years prior to and the fifteen years that follow February 29, 2000.

using System;

public class Example
{
   public static void Main()
   {
      DateTime baseDate = new DateTime(2000, 2, 29);
      Console.WriteLine("    Base Date:        {0:d}\n", baseDate);
      
      // Show dates of previous fifteen years.
      for (int ctr = -1; ctr >= -15; ctr--)
         Console.WriteLine("{0,2} year(s) ago:        {1:d}", 
                           Math.Abs(ctr), baseDate.AddYears(ctr));
      Console.WriteLine();

      // Show dates of next fifteen years.
      for (int ctr = 1; ctr <= 15; ctr++)
         Console.WriteLine("{0,2} year(s) from now:   {1:d}", 
                           ctr, baseDate.AddYears(ctr));
   }
}
// The example displays the following output:
//           Base Date:        2/29/2000
//       
//        1 year(s) ago:        2/28/1999
//        2 year(s) ago:        2/28/1998
//        3 year(s) ago:        2/28/1997
//        4 year(s) ago:        2/29/1996
//        5 year(s) ago:        2/28/1995
//        6 year(s) ago:        2/28/1994
//        7 year(s) ago:        2/28/1993
//        8 year(s) ago:        2/29/1992
//        9 year(s) ago:        2/28/1991
//       10 year(s) ago:        2/28/1990
//       11 year(s) ago:        2/28/1989
//       12 year(s) ago:        2/29/1988
//       13 year(s) ago:        2/28/1987
//       14 year(s) ago:        2/28/1986
//       15 year(s) ago:        2/28/1985
//       
//        1 year(s) from now:   2/28/2001
//        2 year(s) from now:   2/28/2002
//        3 year(s) from now:   2/28/2003
//        4 year(s) from now:   2/29/2004
//        5 year(s) from now:   2/28/2005
//        6 year(s) from now:   2/28/2006
//        7 year(s) from now:   2/28/2007
//        8 year(s) from now:   2/29/2008
//        9 year(s) from now:   2/28/2009
//       10 year(s) from now:   2/28/2010
//       11 year(s) from now:   2/28/2011
//       12 year(s) from now:   2/29/2012
//       13 year(s) from now:   2/28/2013
//       14 year(s) from now:   2/28/2014
//       15 year(s) from now:   2/28/2015
Module Example
   Public Sub Main()
      Dim baseDate As Date = #2/29/2000#
      Console.WriteLine("    Base Date:        {0:d}", baseDate)
      Console.WriteLine()
      
      ' Show dates of previous fifteen years.
      For ctr As Integer = -1 To -15 Step -1
         Console.WriteLine("{0,3} years ago:        {1:d}", 
                           ctr, baseDate.AddYears(ctr))
      Next
      Console.WriteLine()
      ' Show dates of next fifteen years.
      For ctr As Integer = 1 To 15
         Console.WriteLine("{0,3} years from now:   {1:d}", 
                           ctr, baseDate.AddYears(ctr))
      Next      
   End Sub
End Module
' The example displays the following output:
'           Base Date:        2/29/2000
'       
'        1 year(s) ago:        2/28/1999
'        2 year(s) ago:        2/28/1998
'        3 year(s) ago:        2/28/1997
'        4 year(s) ago:        2/29/1996
'        5 year(s) ago:        2/28/1995
'        6 year(s) ago:        2/28/1994
'        7 year(s) ago:        2/28/1993
'        8 year(s) ago:        2/29/1992
'        9 year(s) ago:        2/28/1991
'       10 year(s) ago:        2/28/1990
'       11 year(s) ago:        2/28/1989
'       12 year(s) ago:        2/29/1988
'       13 year(s) ago:        2/28/1987
'       14 year(s) ago:        2/28/1986
'       15 year(s) ago:        2/28/1985
'       
'        1 year(s) from now:   2/28/2001
'        2 year(s) from now:   2/28/2002
'        3 year(s) from now:   2/28/2003
'        4 year(s) from now:   2/29/2004
'        5 year(s) from now:   2/28/2005
'        6 year(s) from now:   2/28/2006
'        7 year(s) from now:   2/28/2007
'        8 year(s) from now:   2/29/2008
'        9 year(s) from now:   2/28/2009
'       10 year(s) from now:   2/28/2010
'       11 year(s) from now:   2/28/2011
'       12 year(s) from now:   2/29/2012
'       13 year(s) from now:   2/28/2013
'       14 year(s) from now:   2/28/2014
'       15 year(s) from now:   2/28/2015

적용 대상