HebrewCalendar.AddYears(DateTime, Int32) Methode

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Quelle:

HebrewCalendar.cs

Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Jahren entspricht.

public:
 override DateTime AddYears(DateTime time, int years);

public override DateTime AddYears (DateTime time, int years);

override this.AddYears : DateTime * int -> DateTime

Public Overrides Function AddYears (time As DateTime, years As Integer) As DateTime

Parameter

time

DateTime

Die DateTime, der years hinzugefügt werden soll.

years

Int32

Die Anzahl der hinzuzufügenden Jahre

Gibt zurück

DateTime

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

Ausnahmen

ArgumentException

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

Beispiele

Im folgenden Codebeispiel werden die Werte mehrerer Komponenten eines DateTime in Bezug auf den hebräischen Kalender angezeigt.

using namespace System;
using namespace System::Globalization;
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();
}

int main()
{
   
   // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
   DateTime myDT = DateTime(2002,4,3,gcnew GregorianCalendar);
   
   // Creates an instance of the HebrewCalendar.
   HebrewCalendar^ myCal = gcnew HebrewCalendar;
   
   // Displays the values of the DateTime.
   Console::WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Hebrew calendar:" );
   DisplayValues( myCal, myDT );
   
   // Adds two years and ten months.
   myDT = myCal->AddYears( myDT, 2 );
   myDT = myCal->AddMonths( myDT, 10 );
   
   // Displays the values of the DateTime.
   Console::WriteLine( "After adding two years and ten months:" );
   DisplayValues( myCal, myDT );
}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in the Hebrew calendar:
   Era:        1
   Year:       5762
   Month:      7
   DayOfYear:  198
   DayOfMonth: 21
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       5765
   Month:      5
   DayOfYear:  138
   DayOfMonth: 21
   DayOfWeek:  Monday

*/

using System;
using System.Globalization;

public class SamplesHebrewCalendar  {

   public static void Main()  {

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

      // Creates an instance of the HebrewCalendar.
      HebrewCalendar myCal = new HebrewCalendar();

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

      // Adds two years and ten months.
      myDT = myCal.AddYears( myDT, 2 );
      myDT = myCal.AddMonths( myDT, 10 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding two years and ten months:" );
      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();
   }
}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in the Hebrew calendar:
   Era:        1
   Year:       5762
   Month:      7
   DayOfYear:  198
   DayOfMonth: 21
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       5765
   Month:      5
   DayOfYear:  138
   DayOfMonth: 21
   DayOfWeek:  Monday

*/

Imports System.Globalization


Public Class SamplesHebrewCalendar   

   Public Shared Sub Main()

      ' Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      Dim myDT As New DateTime(2002, 4, 3, New GregorianCalendar())

      ' Creates an instance of the HebrewCalendar.
      Dim myCal As New HebrewCalendar()

      ' Displays the values of the DateTime.
      Console.WriteLine("April 3, 2002 of the Gregorian calendar equals the following in the Hebrew calendar:")
      DisplayValues(myCal, myDT)

      ' Adds two years and ten months.
      myDT = myCal.AddYears(myDT, 2)
      myDT = myCal.AddMonths(myDT, 10)

      ' Displays the values of the DateTime.
      Console.WriteLine("After adding two years and ten months:")
      DisplayValues(myCal, myDT)

   End Sub

   Public Shared Sub DisplayValues(myCal As Calendar, myDT As DateTime)
      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()
   End Sub

End Class


'This code produces the following output.
'
'April 3, 2002 of the Gregorian calendar equals the following in the Hebrew calendar:
'   Era:        1
'   Year:       5762
'   Month:      7
'   DayOfYear:  198
'   DayOfMonth: 21
'   DayOfWeek:  Wednesday
'
'After adding two years and ten months:
'   Era:        1
'   Year:       5765
'   Month:      5
'   DayOfYear:  138
'   DayOfMonth: 21
'   DayOfWeek:  Monday

Hinweise

Diese Implementierung der HebrewCalendar Klasse erkennt nur die hebräischen Jahre 5343 bis 5999 (1583 bis 2239 im gregorianischen Kalender) an.

Der Tagesteil des resultierenden DateTime ist betroffen, wenn der resultierende Tag kein gültiger Tag im resultierenden Monat des resultierenden Jahres ist. Sie wird in den letzten gültigen Tag im resultierenden Monat des resultierenden Jahres geändert. Cheshvan kann beispielsweise 29 oder 30 Tage haben, abhängig von der Platzierung jüdischer Feiertage. Angenommen, Cheshvan hat 30 Tage im aktuellen Jahr und 29 Tage im folgenden Jahr. Wenn das angegebene Datum der 30. Tag von Cheshvan im aktuellen Jahr und der Wert von years 1 ist, ist das resultierende Datum der 29. Tag von Cheshvan im folgenden Jahr.

Der Monatsteil des resultierenden DateTime ist betroffen, wenn der resultierende Monat kein gültiger Monat im resultierenden Jahr ist. Sie wird in den letzten gültigen Monat des resultierenden Jahres geändert. Wenn der Monat im time Parameter beispielsweise der 13. Monat eines Schaltjahres und der Wert von years 1 ist, ist der Monat im resultierenden DateTime Monat der 12. Monat des Folgejahres, was ein Nicht-Schaltjahr ist. Beachten Sie, dass sich der Monatsteil auch dann möglicherweise auf einen anderen Monat bezieht, wenn er sich nicht ändert. Zum Beispiel ist Adar Beit der 7. Monat in Schaltjahren, aber Nissan ist der 7. Monat in gemeinsamen Jahren.

Diese Implementierung unterstützt nur die aktuelle Ära. Daher wird ausgelöst, ArgumentException wenn das resultierende Jahr außerhalb der Ära des angegebenen DateTimeliegt.

Der Tageszeitteil des resultierenden DateTime bleibt mit dem angegebenen DateTimeidentisch.

Wenn years negativ ist, ist das Ergebnis DateTime früher als der angegebene DateTime.

Die Kind Eigenschaft des zurückgegebenen DateTime Werts DateTimeKind.Unspecifiedentspricht immer . 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);

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

Weitere Informationen

• DateTime
• AddMonths(DateTime, Int32)
• AddWeeks(DateTime, Int32)
• AddDays(DateTime, Int32)
• AddHours(DateTime, Int32)
• AddMinutes(DateTime, Int32)
• AddSeconds(DateTime, Int32)
• AddMilliseconds(DateTime, Double)