DateTimeOffset.AddYears(Int32) Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

DateTimeOffset.cs

Mengembalikan objek baru DateTimeOffset yang menambahkan jumlah tahun tertentu ke nilai instans ini.

public:
 DateTimeOffset AddYears(int years);

public DateTimeOffset AddYears (int years);

member this.AddYears : int -> DateTimeOffset

Public Function AddYears (years As Integer) As DateTimeOffset

Parameter

years

Int32

Beberapa tahun. Angkanya bisa negatif atau positif.

Mengembalikan

DateTimeOffset

Objek yang nilainya adalah jumlah tanggal dan waktu yang diwakili oleh objek saat ini DateTimeOffset dan jumlah tahun yang diwakili oleh years.

Pengecualian

ArgumentOutOfRangeException

Nilai yang DateTimeOffset dihasilkan kurang dari DateTimeOffset.MinValue.

-atau-

Nilai yang DateTimeOffset dihasilkan lebih besar dari DateTimeOffset.MaxValue.

Contoh

Dalam Amerika Serikat, SIM tidak dapat dikeluarkan untuk orang di bawah usia 16 tahun. Contoh berikut menampilkan tanggal terbaru yang mungkin di mana seseorang harus dilahirkan untuk secara hukum diterbitkan sim.

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)

Keterangan

Tidak seperti sebagian besar metode lain yang menambahkan satu unit interval waktu (seperti menit atau hari) ke nilai tanggal dan waktu, AddYears tidak memungkinkan Anda untuk menambahkan bagian pecahan dalam setahun. Untuk menambahkan waktu yang terdiri dari unit waktu lain selain bertahun-tahun DateTimeOffset ke objek, gunakan metode .Add

Catatan

Metode ini mengembalikan objek baru DateTimeOffset . Ini tidak mengubah nilai objek saat ini dengan menambahkan years ke tanggal dan waktunya.