DateTimeOffset.AddYears(Int32) Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

DateTimeOffset.cs

Vrátí nový DateTimeOffset objekt, který přidá zadaný počet roků k hodnotě této instance.

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

Počet let. Číslo může být záporné nebo kladné.

Návraty

DateTimeOffset

Objekt, jehož hodnota je součet data a času reprezentovaných aktuálním DateTimeOffset objektem a počtu roků reprezentovaných objektem years.

Výjimky

ArgumentOutOfRangeException

Výsledná DateTimeOffset hodnota je menší než DateTimeOffset.MinValue.

-nebo-

Výsledná DateTimeOffset hodnota je větší než DateTimeOffset.MaxValue.

Příklady

V USA nelze řidičský průkaz vydat osobám mladším 16 let. Následující příklad zobrazuje poslední možné datum, kdy se osoba musí narodit, aby mohla být legálně vydána řidičský průkaz.

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)

Poznámky

Na rozdíl od většiny ostatních metod, které přidávají jednu jednotku časového intervalu (například minuty nebo dny) k hodnotě data a času, AddYears neumožňuje přidat zlomkové části roku. Pokud chcete do objektu přidat čas, který se skládá z jiných časových jednotek kromě roků DateTimeOffset , použijte metodu Add .

Poznámka

Tato metoda vrátí nový DateTimeOffset objekt. Neupravuje hodnotu aktuálního objektu přidáním years k jeho datu a času.