DateTimeOffset.AddYears(Int32) 메서드

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

Source:

DateTimeOffset.cs

지정된 연도 수를 이 인스턴스의 값에 더하는 새 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가 나타내는 연도 수의 합계인 개체입니다.

예외

ArgumentOutOfRangeException

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

또는

결과 DateTimeOffset 값이 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 에 단일 시간 간격 단위(예: 분 또는 일)를 추가하는 다른 대부분의 메서드와 달리 에서는 1년의 소수 부분을 추가할 수 없습니다. 연도 외 DateTimeOffset 에 다른 시간 단위로 구성된 시간을 개체에 추가하려면 메서드를 Add 사용합니다.

참고

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