EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Yöntem

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

EastAsianLunisolarCalendar.cs

Belirtilen tarihten belirli sayıda yıl uzakta olan tarihi hesaplar.

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

Parametresine belirtilen sayıda yıl time eklenmesinden kaynaklanan yeni DateTime bir.

Özel durumlar

ArgumentException

Sonuç, desteklenen aralığının dışındadır DateTime.

ArgumentOutOfRangeException

time değerinden MinSupportedDateTime küçük veya büyüktür MaxSupportedDateTime.

Açıklamalar

Sonuçta elde edilen gün, sonuçta DateTime elde edilen yılın sonuç ayında geçerli bir gün değilse, sonucun gün kısmı etkilenir. Bu durumda, gün bölümü, sonuçta elde edilen yılın sonuç ayındaki son geçerli güne değiştirilir. Sonuçta elde DateTime edilen ay bölümü belirtilen DateTimeile aynı kalır. Bu uygulama yalnızca geçerli dönemi destekler. Bu nedenle, ArgumentException sonuçta elde edilen yıl belirtilen DateTimedöneminin dışındaysa oluşturulur. Sonuçta elde DateTime edilen günün saati bölümü belirtilen DateTimeile aynı kalır.

Örneğin, Şubat ayının 29 günü olan artık yıllar dışında 28 günü vardır. Belirtilen tarih artık yılın Şubat ayının yirmi dokuzuncu günüyse ve parametrenin years değeri 1 ise, sonuç tarihi sonraki yıl şubat ayının yirmi sekizinci günü olur.

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 özelliğini time koruyabilirsinizKind.

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

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