DateTimeOffset.AddYears(Int32) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

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 temsil edilen yıl yearssayı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 örnekte, bir kişinin yasal olarak bir sürücü lisansı verilebilmesi için doğması gereken en son olası tarih gösterilir.

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 tanımaz. Bir nesneye yıllara ek olarak diğer zaman birimlerinden oluşan bir DateTimeOffset zaman eklemek için yöntemini kullanın Add .

Not

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