HebrewCalendar.AddYears-Methode

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

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

Syntax

'Declaration
Public Overrides Function AddYears ( _
    time As DateTime, _
    years As Integer _
) As DateTime
'Usage
Dim instance As HebrewCalendar
Dim time As DateTime
Dim years As Integer
Dim returnValue As DateTime

returnValue = instance.AddYears(time, years)

public override DateTime AddYears (
    DateTime time,
    int years
)

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

public DateTime AddYears (
    DateTime time, 
    int years
)

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

Parameter

• time
  Die DateTime, der years hinzugefügt werden soll.

• years
  Die Anzahl der hinzuzufügenden Jahre.

Rückgabewert

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

Ausnahmen

Hinweise

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

Wenn der resultierende Tag kein gültiger Tag im resultierenden Monat des resultierenden Jahres ist, ist auch der Tag der resultierenden DateTime betroffen. Er wird in den letzten gültigen Tag im resultierenden Monat des resultierenden Jahres geändert. Beispielsweise kann der Monat Cheschwan 29 oder 30 Tage haben, abhängig davon, wie die jüdischen Feiertage liegen. Angenommen, der Cheschwan hat im aktuellen Jahr 30 Tage und im folgenden Jahr 29 Tage. Wenn das angegebene Datum der 30. Tag im Cheschwan im aktuellen Jahr und der Wert von years 1 ist, ist das resultierende Datum der 29. Tag im Cheschwan des folgenden Jahres.

Wenn der resultierende Monat kein gültiger Monat im resultierenden Jahr ist, ist auch der Monat der resultierenden DateTime betroffen. Er wird in den letzten gültigen Monat im resultierenden Jahr geändert. Wenn es sich z. B. beim Monat im time-Parameter um den 13. Monat eines Schaltjahres handelt und der Wert von years 1 ist, ist der Monat in der resultierenden DateTime der 12. Monat des Folgejahres, das kein Schaltjahr ist. Beachten Sie, dass selbst dann, wenn sich die Monatsangabe nicht ändert, diese weiterhin auf einen anderen Monat verweisen kann. Beispielsweise ist in Schaltjahren der Adar Bet der siebte Monat, in Gemeinjahren ist dies jedoch der Nissan.

Diese Implementierung unterstützt ausschließlich den aktuellen Zeitraum. Deshalb wird eine ArgumentException ausgelöst, wenn das resultierende Jahr außerhalb des Zeitraums der angegebenen DateTime liegt.

Die Tageszeit der resultierenden DateTime entspricht der der angegebenen DateTime.

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

Beispiel

Im folgenden Codebeispiel werden die Werte mehrerer Komponenten von DateTime nach dem hebräischen Kalender angezeigt.

Imports System
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 'Main

   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 'DisplayValues

End Class 'SamplesHebrewCalendar 



'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

*/

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

*/

import System.* ;
import System.Globalization.* ;

public class SamplesHebrewCalendar
{
    public static void main(String[] args)
    {
        // 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);
    } //main
    
    public static void DisplayValues(Calendar myCal, DateTime myDT)
    {
        Console.WriteLine("   Era:        {0}", 
            System.Convert.ToString(myCal.GetEra(myDT)));
        Console.WriteLine("   Year:       {0}", 
            System.Convert.ToString(myCal.GetYear(myDT)));
        Console.WriteLine("   Month:      {0}", 
            System.Convert.ToString(myCal.GetMonth(myDT)));
        Console.WriteLine("   DayOfYear:  {0}", 
            System.Convert.ToString(myCal.GetDayOfYear(myDT)));
        Console.WriteLine("   DayOfMonth: {0}", 
            System.Convert.ToString(myCal.GetDayOfMonth(myDT)));
        Console.WriteLine("   DayOfWeek:  {0}", 
            System.Convert.ToString(myCal.GetDayOfWeek(myDT)));
        Console.WriteLine();
    } //DisplayValues
} //SamplesHebrewCalendar
 
/*
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
*/

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HebrewCalendar-Klasse
HebrewCalendar-Member
System.Globalization-Namespace
System.DateTime
AddMonths
Calendar.AddWeeks
Calendar.AddDays
Calendar.AddHours
Calendar.AddMinutes
Calendar.AddSeconds
Calendar.AddMilliseconds