DateTimeOffset.AddYears(Int32) Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

DateTimeOffset.cs

Zwraca nowy DateTimeOffset obiekt, który dodaje określoną liczbę lat do wartości tego wystąpienia.

public:
 DateTimeOffset AddYears(int years);

public DateTimeOffset AddYears (int years);

member this.AddYears : int -> DateTimeOffset

Public Function AddYears (years As Integer) As DateTimeOffset

Parametry

years

Int32

Wiele lat. Liczba może być dodatnia lub ujemna.

Zwraca

DateTimeOffset

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez bieżący DateTimeOffset obiekt i liczbę lat reprezentowanych przez obiekt years.

Wyjątki

ArgumentOutOfRangeException

DateTimeOffset Wynikowa wartość jest mniejsza niż DateTimeOffset.MinValue.

-lub-

DateTimeOffset Wynikowa wartość jest większa niż DateTimeOffset.MaxValue.

Przykłady

W Stany Zjednoczone prawa jazdy nie mogą być wydawane osobom poniżej 16 lat. Poniższy przykład przedstawia najnowszą możliwą datę, w której osoba musi się urodzić, aby legalnie wydać prawo jazdy.

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)

Uwagi

W przeciwieństwie do większości innych metod, które dodają pojedynczą jednostkę interwału czasu (na przykład minuty lub dni) do wartości daty i godziny, AddYears nie umożliwia dodawania części ułamkowych roku. Aby dodać czas składający się z innych jednostek czasu oprócz lat do DateTimeOffset obiektu, użyj Add metody .

Uwaga

Ta metoda zwraca nowy DateTimeOffset obiekt. Nie modyfikuje wartości bieżącego obiektu przez dodanie years jej do daty i godziny.