DateTimeOffset.AddYears(Int32) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

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 並不會讓您新增一年的小數部分。 若要在 物件中新增包含其他時間單位的時間，除了將年數新增至 DateTimeOffset 物件，請使用 Add 方法。

注意

這個方法會傳回新的 DateTimeOffset 物件。 它不會藉由新增 years 至目前物件的日期和時間來修改其值。