DateTimeOffset.AddYears(Int32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回一个新 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 其日期和时间来修改当前对象的值。