DateTime.AddYears(Int32) DateTime.AddYears(Int32) DateTime.AddYears(Int32) DateTime.AddYears(Int32) Method

정의

지정된 연도 수를 이 인스턴스의 값에 더하는 새 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 Int32 Int32 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.

다음 예제를 사용 하 여 합니다 AddYears 메서드는 DateTime 윤년 하루를 나타내는 값입니다.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

적용 대상