EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Metode

Definisi

Ruang nama:

System.Globalization

Rakitan:

System.Runtime.dll

Sumber:

EastAsianLunisolarCalendar.cs

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

time

DateTime

yang DateTime akan ditambahkan years.

years

Int32

Jumlah tahun yang akan ditambahkan.

Mengembalikan

DateTime

DateTime Baru yang dihasilkan dari menambahkan jumlah tahun yang ditentukan ke time parameter .

Pengecualian

ArgumentException

Hasilnya berada di luar rentang yang DateTimedidukung dari .

ArgumentOutOfRangeException

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)