DateTimeOffset.AddYears(Int32) Метод

Определение

Пространство имен:

System

Сборки:

netstandard.dll, 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 , используйте метод.

Note

Этот метод возвращает новый DateTimeOffset объект. Он не изменяет значение текущего объекта, добавляя years его к дате и времени.