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 其日期和时间来修改当前对象的值。

适用于