DateTimeOffset.AddYears(Int32) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.