Aracılığıyla paylaş


EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Yöntem

Tanım

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

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

Özel durumlar

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

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)

Şunlara uygulanır