Поделиться через


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.

Исключения

Полученное 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 не позволяет добавлять дробные части года. Чтобы добавить к объекту время, состоящее из других единиц времени в дополнение к годам DateTimeOffsetAdd , используйте метод .

Примечание

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

Применяется к