DateTimeOffset.AddYears(Int32) 메서드

정의

지정된 연도 수를 이 인스턴스의 값에 더하는 새 DateTimeOffset 개체를 반환합니다.Returns a new DateTimeOffset object that adds a specified number of years to the value of this instance.

public:
 DateTimeOffset AddYears(int years);
public DateTimeOffset AddYears (int years);
member this.AddYears : int -> DateTimeOffset
Public Function AddYears (years As Integer) As DateTimeOffset

매개 변수

years
Int32

연도 수입니다.A number of years. 숫자는 음수가 될 수도 있고 양수가 될 수도 있습니다.The number can be negative or positive.

반환

값이 현재 DateTimeOffset 개체가 나타내는 날짜 및 시간과 years가 나타내는 연도 수의 합계인 개체입니다.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of years represented by years.

예외

결과 DateTimeOffset 값이 MinValue보다 작습니다.The resulting DateTimeOffset value is less than MinValue.

-또는--or- 결과 DateTimeOffset 값이 MaxValue보다 큽니다.The resulting DateTimeOffset value is greater than MaxValue.

예제

미국에서 드라이버의 라이선스를 발급할 수 없습니다 개인에 게 16 세 미만입니다.In the United States, driver's licenses cannot be issued to persons under 16 years of age. 다음 예제에서는 날짜 또는 법적 운전 면허증 발급 하기 위해 태어난 해야 사용자를 표시 합니다.The following example displays the latest possible date on which a person must be born in order to legally be issued a driver's license.

const int minimumAge = 16;
DateTimeOffset dateToday = DateTimeOffset.Now;
DateTimeOffset latestBirthday = dateToday.AddYears(-1 * minimumAge);
Console.WriteLine("To possess a driver's license, you must have been born on or before {0:d}.", 
                  latestBirthday);
Const minimumAge As Integer = 16
Dim dateToday As DateTimeOffset = DateTimeOffset.Now
Dim latestBirthday As DateTimeOffset = dateToday.AddYears(-1 * minimumAge)
Console.WriteLine("To possess a driver's license, you must have been born on or before {0:d}.", _
                  latestBirthday)

설명

날짜 및 시간 값에 단일 시간 간격 단위 (예: 분 또는 일)를 추가 하는 다른 메서드와 달리 AddYears에서는 연도의 소수 부분을 더할 수 없습니다.Unlike most of the other methods that add a single time interval unit (such as minutes or days) to a date and time value, AddYears does not enable you to add fractional parts of a year. DateTimeOffset 개체에 연도 외에 다른 시간 단위로 구성 된 시간을 추가 하려면 Add 메서드를 사용 합니다.To add a time that consists of other time units in addition to years to a DateTimeOffset object, use the Add method.

참고

이 메서드는 새 DateTimeOffset 개체를 반환 합니다.This method returns a new DateTimeOffset object. 날짜 및 시간에 months을 추가 하 여 현재 개체의 값을 수정 하지 않습니다.It does not modify the value of the current object by adding months to its date and time.

적용 대상