(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Calendar.AddYears-Methode

Gibt beim Überschreiben in einer abgeleiteten Klasse eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Jahren entspricht.

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

public abstract DateTime AddYears(
	DateTime time,
	int years
)

Parameter

time
Typ: System.DateTime
Die DateTime, der Jahre hinzugefügt werden sollen.
years
Typ: System.Int32
Die Anzahl der hinzuzufügenden Jahre.

Rückgabewert

Typ: System.DateTime
Die DateTime, die sich ergibt, wenn der angegebenen DateTime die angegebene Anzahl von Jahren hinzugefügt wird.

AusnahmeBedingung
ArgumentException

Die resultierende DateTime liegt außerhalb des unterstützten Bereichs dieses Kalenders.

ArgumentOutOfRangeException

years liegt außerhalb des unterstützten Bereichs des DateTime-Rückgabewerts.

Der angegebenen DateTime wird der years-Wert hinzugefügt. Wenn years negativ ist, liegt die resultierende DateTime zeitlich vor der angegebenen DateTime.

Wenn der resultierende Tag kein gültiger Tag im resultierenden Monat des resultierenden Jahrs ist, ist auch der Tag der resultierenden DateTime betroffen. Er wird in den letzten gültigen Tag im resultierenden Monat des resultierenden Jahrs geändert. Der Monat der resultierenden DateTime ist betroffen, wenn der resultierende Monat kein gültiger Monat des resultierenden Jahrs ist. Er wird in den letzten gültigen Monat des resultierenden Jahrs geändert. Der Zeitraum der resultierenden DateTime ist betroffen, wenn das resultierende Jahr außerhalb des Zeitraums der angegebenen DateTime liegt. Die Tageszeit der resultierenden DateTime entspricht der der angegebenen DateTime.

Der Februar hat im gregorianischen Kalender beispielsweise 28 Tage, in einem Schaltjahr hat er jedoch 29 Tage. Wenn das angegebene Datum der 29. Tag im Februar eines Schaltjahrs und der Wert von years 1 sind, ist das resultierende Datum der 28. Februar des folgenden Jahres.

Wenn years negativ ist, liegt die resultierende DateTime zeitlich vor der angegebenen DateTime.

Der Wert der Kind-Eigenschaft des zurückgegebenen DateTime-Werts ist immer DateTimeKind.Unspecified. Sie können die Kind-Eigenschaft des time-Parameters beibehalten, indem Sie die DateTime.SpecifyKind-Methode aufrufen, wie im folgenden Beispiel gezeigt.


returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind);


Im folgenden Codebeispiel werden die Member der Calendar-Klasse veranschaulicht.


using System;
using System.Globalization;


public class SamplesCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Uses the default calendar of the InvariantCulture.
      Calendar myCal = CultureInfo.InvariantCulture.Calendar;

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar:" );
      DisplayValues( myCal, myDT );

      // Adds 5 to every component of the DateTime.
      myDT = myCal.AddYears( myDT, 5 );
      myDT = myCal.AddMonths( myDT, 5 );
      myDT = myCal.AddWeeks( myDT, 5 );
      myDT = myCal.AddDays( myDT, 5 );
      myDT = myCal.AddHours( myDT, 5 );
      myDT = myCal.AddMinutes( myDT, 5 );
      myDT = myCal.AddSeconds( myDT, 5 );
      myDT = myCal.AddMilliseconds( myDT, 5 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding 5 to each component of the DateTime:" );
      DisplayValues( myCal, myDT );

   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:          {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:         {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:        {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:    {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth:   {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:    {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine( "   Hour:         {0}", myCal.GetHour( myDT ) );
      Console.WriteLine( "   Minute:       {0}", myCal.GetMinute( myDT ) );
      Console.WriteLine( "   Second:       {0}", myCal.GetSecond( myDT ) );
      Console.WriteLine( "   Milliseconds: {0}", myCal.GetMilliseconds( myDT ) );
      Console.WriteLine();
   }

}


/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar:
   Era:          1
   Year:         2002
   Month:        4
   DayOfYear:    93
   DayOfMonth:   3
   DayOfWeek:    Wednesday
   Hour:         0
   Minute:       0
   Second:       0
   Milliseconds: 0

After adding 5 to each component of the DateTime:
   Era:          1
   Year:         2007
   Month:        10
   DayOfYear:    286
   DayOfMonth:   13
   DayOfWeek:    Saturday
   Hour:         5
   Minute:       5
   Second:       5
   Milliseconds: 5

*/


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft