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 物件所表示之日期及時間加上 years 所表示之年份數的總和。

例外狀況

範例

在美國中,駕駛的授權無法核發給 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 至目前物件的日期和時間來修改其值。

適用於