DateTimeOffset.AddYears(Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Objek yang nilainya adalah jumlah tanggal dan waktu yang diwakili oleh objek saat ini DateTimeOffset dan jumlah tahun yang diwakili oleh years
.
Pengecualian
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.