HijriCalendar.AddYears-Methode

Gibt ein DateTime-Objekt zurück, das dem angegebenen Zeitintervall zum angegebenen DateTime-Objekt 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 HijriCalendar
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
  Das DateTime-Objekt, dem Jahre hinzugefügt werden sollen.

• years
  Die Anzahl der hinzuzufügenden Jahre.

Rückgabewert

Das DateTime-Objekt, das sich ergibt, wenn dem angegebenen DateTime-Objekt die angegebene Anzahl von Jahren hinzugefügt wird.

Ausnahmen

Hinweise

Wenn der resultierende Tag kein gültiger Tag im resultierenden Monat des resultierenden Jahres ist, ist auch der Tag des resultierenden DateTime-Objekts betroffen. Er wird in den letzten gültigen Tag im resultierenden Monat des resultierenden Jahres geändert. Der Monat des resultierenden DateTime-Objekts entspricht dem des angegebenen DateTime-Objekts. Diese Implementierung unterstützt ausschließlich den aktuellen Zeitraum. Deshalb wird eine ArgumentException ausgelöst, wenn das resultierende Jahr außerhalb des Zeitraums des angegebenen DateTime-Objekts liegt. Die Tageszeit des resultierenden DateTime-Objekts entspricht der des angegebenen DateTime-Objekts.

Zulhijjah hat beispielsweise 29 Tage, nur in einem Schaltjahr hat er 30 Tage. Wenn das angegebene Datum der 30. Tag im Zulhijjah in einem Schaltjahr und der Wert von years 1 ist, ist das resultierende Datum der 29. Tag im Zulhijjah des folgenden Jahres.

Wenn years negativ ist, liegt das resultierende DateTime-Objekt zeitlich vor dem angegebenen DateTime-Objekt.

Beispiel

Im folgenden Codebeispiel werden die Werte mehrerer Komponenten eines DateTime-Objekts nach dem Hijri-Kalender angezeigt.

Imports System
Imports System.Globalization


Public Class SamplesHijriCalendar   

   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 HijriCalendar.
      Dim myCal As New HijriCalendar()

      ' Displays the values of the DateTime.
      Console.WriteLine("April 3, 2002 of the Gregorian calendar equals the following in the Hijri 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 'SamplesHijriCalendar 


'This code produces the following output.

'

'April 3, 2002 of the Gregorian calendar equals the following in the Hijri calendar:

'   Era:        1

'   Year:       1423

'   Month:      1

'   DayOfYear:  21

'   DayOfMonth: 21

'   DayOfWeek:  Wednesday

'

'After adding two years and ten months:

'   Era:        1

'   Year:       1425

'   Month:      11

'   DayOfYear:  316

'   DayOfMonth: 21

'   DayOfWeek:  Saturday

using System;
using System.Globalization;


public class SamplesHijriCalendar  {

   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 HijriCalendar.
      HijriCalendar myCal = new HijriCalendar();

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Hijri 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 Hijri calendar:
   Era:        1
   Year:       1423
   Month:      1
   DayOfYear:  21
   DayOfMonth: 21
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       1425
   Month:      11
   DayOfYear:  316
   DayOfMonth: 21
   DayOfWeek:  Saturday

*/

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 HijriCalendar.
   HijriCalendar^ myCal = gcnew HijriCalendar;
   
   // Displays the values of the DateTime.
   Console::WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Hijri 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 Hijri calendar:
   Era:        1
   Year:       1423
   Month:      1
   DayOfYear:  21
   DayOfMonth: 21
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       1425
   Month:      11
   DayOfYear:  316
   DayOfMonth: 21
   DayOfWeek:  Saturday

*/

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

public class SamplesHijriCalendar
{  
    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 HijriCalendar.
        HijriCalendar myCal =  new HijriCalendar();

        // Displays the values of the DateTime.
        Console.WriteLine("April 3,2002 of the Gregorian calendar equals the"
            + " following in the Hijri 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
} //SamplesHijriCalendar 

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in the 
Hijri calendar:
   Era:        1
   Year:       1423
   Month:      1
   DayOfYear:  21
   DayOfMonth: 21
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       1425
   Month:      11
   DayOfYear:  316
   DayOfMonth: 21
   DayOfWeek:  Saturday

*/

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

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