Sdílet prostřednictvím


EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Metoda

Definice

Vypočítá datum, které je zadaný počet roků od zadaného data.

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

Parametry

time
DateTime

Do DateTime kterého se má přidat years.

years
Int32

Počet roků, které se mají přičíst

Návraty

Nový DateTime , který je výsledkem přidání zadaného počtu roků do parametru time .

Výjimky

Výsledek je mimo podporovaný rozsah .DateTime

time je menší než MinSupportedDateTime nebo větší než MaxSupportedDateTime.

Poznámky

Denní část výsledného DateTime roku je ovlivněna, pokud výsledný den není platným dnem ve výsledném měsíci výsledného roku. V tomto případě se část dne změní na poslední platný den ve výsledném měsíci výsledného roku. Měsíční část výsledného výsledku DateTime zůstane stejná jako zadaná DateTimečást . Tato implementace podporuje pouze aktuální éru. Proto je vyvolán, ArgumentException pokud je výsledný rok mimo éru zadaného DateTime. Denní doba výsledné DateTime části zůstává stejná jako zadaná DateTimečást .

Například únor má 28 dní s výjimkou přestupných roků, kdy má 29 dnů. Pokud je zadané datum dvacátým devátým dnem února v přestupném roce a hodnota parametru years je 1, bude výsledným datem dvacátý osmý den února v následujícím roce.

Pokud years je negativní, výsledek DateTime je starší než zadaný DateTimeparametr .

Vlastnost Kind vrácené DateTime hodnoty se vždy rovná DateTimeKind.Unspecified. Vlastnost parametru Kindtime můžete zachovat voláním DateTime.SpecifyKind metody, jak ukazuje následující příklad.

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

Platí pro