HebrewCalendar.AddYears(DateTime, Int32) Yöntem

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

HebrewCalendar.cs

DateTime Belirtilen sayıda yıl uzaklıkta DateTimebelirtilen bir döndürür.

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

Parametreler

time

DateTime

DateTime öğesinin ekleneceği yeryears.

years

Int32

Eklenecek yıl sayısı.

Döndürülenler

DateTime

Bu DateTime , belirtilen yıl sayısını belirtilen DateTimeöğesine eklemenin sonucu olur.

Özel durumlar

ArgumentException

Elde edilen DateTime değer desteklenen aralığın dışındadır.

Örnekler

Aşağıdaki kod örneği, İbranice takvim açısından bir DateTime öğesinin çeşitli bileşenlerinin değerlerini görüntüler.

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

Açıklamalar

Sınıfın HebrewCalendar bu uygulaması yalnızca 5343 ile 5999 arasındaki İbranice yılları tanır (Gregoryen takvimde 1583 ile 2239 arası).

Sonuçta elde edilen gün, sonuçta DateTime elde edilen yılın sonuç ayında geçerli bir gün değilse, sonuçta elde edilen günün gün bölümü etkilenir. Bu, sonuçta elde edilen yılın sonuç ayındaki son geçerli güne değiştirilir. Örneğin, Yahudi tatillerinin yerleşimlerine bağlı olarak Cheshvan'ın 29 veya 30 günü olabilir. Cheshvan'ın geçerli yılda 30 günü ve sonraki yıl 29 günü olduğunu varsayalım. Belirtilen tarih, geçerli yılda Cheshvan'ın 30. günü ve değeri years 1 ise, elde edilen tarih sonraki yıl Cheshvan'ın 29. günü olur.

Sonuçta elde edilen ay, sonuçta DateTime elde edilen yılda geçerli bir ay değilse, elde edilen ayın ay bölümü etkilenir. Sonuçta elde edilen yılın son geçerli ayına değiştirilir. Örneğin, parametredeki time ay artık yılın 13. ayı ve değeri years 1 ise, sonuçta elde DateTime edilen ay sonraki yılın 12. ayıdır ve bu artık olmayan bir yıldır. Ay bölümü değişmese bile farklı bir aya başvurabileceğini unutmayın. Örneğin, Adar Beit artık yılların 7. ayıdır, ancak Nissan ortak yılların 7. ayıdır.

Bu uygulama yalnızca geçerli dönemi destekler. Bu nedenle, ArgumentException sonuçta elde edilen yıl belirtilen DateTimeçağın dışındaysa oluşturulur.

Sonuçta elde DateTime edilen günün saati bölümü, belirtilen DateTimeile aynı kalır.

Negatifse years , sonuç DateTime belirtilen DateTimedeğerinden önce olur.

Kind Döndürülen DateTime değerin özelliği her zaman eşittirDateTimeKind.Unspecified. Aşağıdaki örnekte gösterildiği gibi yöntemini çağırarak DateTime.SpecifyKind parametresinin time özelliğini koruyabilirsinizKind.

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

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

Ayrıca bkz.

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