DateTimeOffset.AddYears(Int32) 메서드

정의

지정된 연도 수를 이 인스턴스의 값에 더하는 새 DateTimeOffset 개체를 반환합니다.

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

연도 수입니다. 숫자는 음수가 될 수도 있고 양수가 될 수도 있습니다.

반환

DateTimeOffset

값이 현재 DateTimeOffset 개체가 나타내는 날짜 및 시간과 years가 나타내는 연도 수의 합계인 개체입니다.

예외

결과 DateTimeOffset 값이 MinValue보다 작습니다.

또는

결과 DateTimeOffset 값이 MaxValue보다 큽니다.

예제

미국 16세 미만의 사용자에게는 운전면허증을 발급할 수 없습니다. 다음 예제에서는 법적으로 운전 면허증을 발급하기 위해 사람이 태어나야 할 가능한 최신 날짜를 표시합니다.

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);
let minimumAge = 16
let dateToday = DateTimeOffset.Now
let latestBirthday = dateToday.AddYears(-1 * minimumAge)
printfn $"To possess a driver's license, you must have been born on or before {latestBirthday:d}."
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 에 단일 시간 간격 단위(예: 분 또는 일)를 추가하는 다른 대부분의 메서드와 달리 연도의 소수 부분을 추가할 수 없습니다. 연도 외에도 DateTimeOffset 다른 시간 단위로 구성된 시간을 개체에 추가하려면 이 메서드를 Add 사용합니다.

참고

이 메서드는 새 DateTimeOffset 개체를 반환합니다. 날짜 및 시간에 추가하여 months 현재 개체의 값을 수정하지 않습니다.

적용 대상