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

Definition

Gibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl von Jahren zum Wert dieser Instanz addiert.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

Parameter

value
Int32 Int32 Int32 Int32

Eine Anzahl von Jahren.A number of years. Der value-Parameter kann negativ oder positiv sein.The value parameter can be negative or positive.

Gibt zurück

Ein Objekt, dessen Wert die Summe aus der von dieser Instanz dargestellten Datums- und Uhrzeitangabe und der durch value dargestellten Anzahl von Jahren ist.An object whose value is the sum of the date and time represented by this instance and the number of years represented by value.

Ausnahmen

value oder der resultierende DateTime-Wert ist kleiner als MinValue oder größer als MaxValue.value or the resulting DateTime is less than MinValue or greater than MaxValue.

Hinweise

Diese Methode ändert nicht den Wert dieses DateTime -Objekts.This method does not change the value of this DateTime object. Stattdessen wird ein neues DateTime -Objekt zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.Instead, it returns a new DateTime object whose value is the result of this operation.

Die AddYears -Methode berechnet das resultierende Jahr in Rechnung.The AddYears method calculates the resulting year taking into account leap years. Der Monats-und Uhrzeitanteil des resultierenden DateTime Objekts bleibt unverändert wie diese Instanz.The month and time-of-day part of the resulting DateTime object remains the same as this instance.

Wenn die aktuelle Instanz den springday in einem Schaltjahr darstellt, hängt der Rückgabewert vom Zieldatum ab:If the current instance represents the leap day in a leap year, the return value depends on the target date:

  • Wenn value aucheinSchaltDateTime.Year Jahr ist, stellt der Rückgabewert den Schalttag in diesem Jahr dar. + If value + DateTime.Year is also a leap year, the return value represents the leap day in that year. Wenn beispielsweise vier Jahre zum 29. Februar 2012 hinzugefügt werden, ist das zurückgegebene Datum der 29. Februar 2016.For example, if four years is added to February 29, 2012, the date returned is February 29, 2016.

  • Wenn value keinSchaltjahrDateTime.Year ist, stellt der Rückgabewert den Tag vor dem Schalttag in diesem Jahr dar. + If value + DateTime.Year is not a leap year, the return value represents the day before the leap day in that year. Wenn beispielsweise ein Jahr zum 29. Februar 2012 hinzugefügt wird, ist das zurückgegebene Datum der 28. Februar 2013.For example, if one year is added to February 29, 2012, the date returned is February 28, 2013.

Das folgende Beispiel veranschaulicht die Verwendung AddYears der-Methode DateTime mit einem Wert, der ein Schaltjahr darstellt.The following example illustrates using the AddYears method with a DateTime value that represents a leap year day. Es zeigt das Datum für die 15 Jahre vor und die 15 Jahre an, die nach dem 29. Februar 2000 liegen.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

Gilt für: