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) 无法添加一年的小数部分。 若要向 对象添加由其他时间单位以及年份 DateTimeOffset 组成的时间，请使用 Add 方法。

注意

此方法返回一个新 DateTimeOffset 对象。 它不会通过将添加到 years 当前对象的日期和时间来修改其值。