DateTimeOffset.AddYears(Int32) Metod

Definition

Returnerar ett nytt DateTimeOffset objekt som lägger till ett angivet antal år i värdet för den här instansen.

public:
 DateTimeOffset AddYears(int years);
public DateTimeOffset AddYears(int years);
member this.AddYears : int -> DateTimeOffset
Public Function AddYears (years As Integer) As DateTimeOffset

Parametrar

years
Int32

Ett antal år. Talet kan vara negativt eller positivt.

Returer

Ett objekt vars värde är summan av datum och tid som representeras av det aktuella DateTimeOffset objektet och antalet år som representeras av years.

Undantag

Det resulterande DateTimeOffset värdet är mindre än DateTimeOffset.MinValue.

-eller-

Det resulterande DateTimeOffset värdet är större än DateTimeOffset.MaxValue.

Exempel

I United States kan körkort inte utfärdas till personer under 16 år. I följande exempel visas det senaste möjliga datumet då en person måste födas för att kunna utfärdas ett körkort lagligt.

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)

Kommentarer

Till skillnad från de flesta andra metoder som lägger till en enskild tidsintervallenhet (till exempel minuter eller dagar) till ett datum- och tidsvärde, AddYears kan du inte lägga till bråkdelar av ett år. Om du vill lägga till en tid som består av andra tidsenheter utöver år till ett DateTimeOffset objekt använder du Add metoden .

Note

Den här metoden returnerar ett nytt DateTimeOffset objekt. Det ändrar inte värdet för det aktuella objektet genom att lägga years till dess datum och tid.

Gäller för