EastAsianLunisolarCalendar.AddYears(DateTime, 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.
Menghitung tanggal yang merupakan jumlah tahun yang ditentukan dari tanggal yang ditentukan.
public:
override DateTime AddYears(DateTime time, int years);
public override DateTime AddYears (DateTime time, int years);
override this.AddYears : DateTime * int -> DateTime
Public Overrides Function AddYears (time As DateTime, years As Integer) As DateTime
Parameter
- years
- Int32
Jumlah tahun yang akan ditambahkan.
Mengembalikan
DateTime Baru yang dihasilkan dari menambahkan jumlah tahun yang ditentukan ke time
parameter .
Pengecualian
Hasilnya berada di luar rentang yang DateTimedidukung dari .
time
kurang dari MinSupportedDateTime atau lebih besar dari MaxSupportedDateTime.
Keterangan
Bagian hari dari hasil DateTime terpengaruh jika hari yang dihasilkan bukan hari yang valid pada bulan yang dihasilkan dari tahun yang dihasilkan. Dalam hal ini, bagian hari diubah ke hari terakhir yang valid pada bulan yang dihasilkan dari tahun yang dihasilkan. Bagian bulan dari yang dihasilkan DateTime tetap sama dengan yang ditentukan DateTime. Implementasi ini hanya mendukung era saat ini. Oleh karena itu, ArgumentException dilemparkan jika tahun yang dihasilkan berada di luar era yang ditentukan DateTime. Bagian waktu hari dari hasil DateTime tetap sama dengan yang ditentukan DateTime.
Misalnya, Februari memiliki 28 hari, kecuali selama tahun kabut ketika memiliki 29 hari. Jika tanggal yang ditentukan adalah hari kedua puluh sembilan Februari dalam tahun kampung dan nilai years
parameter adalah 1, tanggal yang dihasilkan akan menjadi hari kedua puluh delapan Februari pada tahun berikutnya.
Jika years
negatif, hasilnya DateTime lebih awal dari yang ditentukan DateTime.
Properti Kind dari nilai yang dikembalikan DateTime selalu sama dengan DateTimeKind.Unspecified. Anda dapat mempertahankan Kind properti time
parameter dengan memanggil DateTime.SpecifyKind metode , seperti yang ditunjukkan contoh berikut.
returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind)