다음을 통해 공유


EastAsianLunisolarCalendar.AddYears(DateTime, Int32) 메서드

정의

지정된 날짜에서 지정된 연도 수만큼 경과한 날짜를 계산합니다.

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

매개 변수

time
DateTime

years를 더할 DateTime입니다.

years
Int32

더할 연도 수입니다.

반환

time 매개 변수에 지정된 연도 수를 더한 결과로 만들어지는 새 DateTime입니다.

예외

결과가 DateTime의 지원되는 범위를 벗어난 경우

time이(가) MinSupportedDateTime보다 작거나 MaxSupportedDateTime보다 큽니다.

설명

결과 날짜가 결과 연도의 결과 월에 유효한 날짜가 아닌 경우 결과 DateTime 날짜의 일 부분이 영향을 받습니다. 이 경우 일 부분은 결과 연도의 결과 월에서 마지막 유효한 날짜로 변경됩니다. 결과 DateTime 의 월 부분은 지정된 와 동일하게 유지됩니다 DateTime. 이 구현은 현재 시대만 지원합니다. 따라서 ArgumentException 결과 연도가 지정된 의 시대를 벗어나면 이 throw됩니다 DateTime. 결과 DateTime 부분의 시간 부분은 지정된 와 동일하게 유지됩니다 DateTime.

예를 들어 2월에는 29일이 있는 윤년을 제외하고 28일이 있습니다. 지정된 날짜가 윤년에서 2월 29일이고 매개 변수 값 years 이 1이면 결과 날짜는 다음 해의 2월 28일이 됩니다.

가 음수이면 years 결과는 DateTime 지정된 DateTime보다 이전입니다.

반환 DateTime 된 값의 속성은 Kind 항상 와 같습니다DateTimeKind.Unspecified. 다음 예제와 같이 메서드를 time 호출 DateTime.SpecifyKind 하여 매개 변수의 속성을 유지할 Kind 수 있습니다.

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

적용 대상