DateTimeOffset.AddYears(Int32) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

DateTimeOffset.cs

Bu örneğin değerine belirtilen sayıda yıl ekleyen yeni DateTimeOffset bir nesne döndürür.

public:
 DateTimeOffset AddYears(int years);

public DateTimeOffset AddYears(int years);

member this.AddYears : int -> DateTimeOffset

Public Function AddYears (years As Integer) As DateTimeOffset

Parametreler

years

Int32

Birkaç yıl. Sayı negatif veya pozitif olabilir.

Döndürülenler

DateTimeOffset

Değeri geçerli DateTimeOffset nesneyle temsil edilen tarih ve saatin toplamı ve ile yearstemsil edilen yıl sayısı olan bir nesne.

Özel durumlar

ArgumentOutOfRangeException

Sonuçta elde edilen DateTimeOffset değer DateTimeOffset.MinValue değerinden küçüktür.

-veya-

Sonuçta elde edilen DateTimeOffset değer DateTimeOffset.MaxValue değerinden büyüktür.

Örnekler

Birleşik Devletler 16 yaşından küçük kişilere ehliyet verilemez. Aşağıdaki örnek, yasal olarak bir sürücü belgesi verilebilmesi için bir kişinin doğması gereken en son tarihi gösterir.

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)

Açıklamalar

Tarih ve saat değerine tek bir zaman aralığı birimi (dakika veya gün gibi) ekleyen diğer yöntemlerin çoğundan farklı olarak, AddYears bir yılın kesirli bölümlerini eklemenize olanak sağlamaz. Bir nesneye yıllara ek olarak diğer zaman birimlerinden oluşan bir DateTimeOffset zaman eklemek için yöntemini kullanın Add .

Note

Bu yöntem yeni DateTimeOffset bir nesne döndürür. Geçerli nesnenin değerini tarih ve saatine ekleyerek years değiştirmez.