EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Metode

Definisi

Ruang nama:

System.Globalization

Rakitan:

System.Runtime.dll

Sumber:

EastAsianLunisolarCalendar.cs

Menghitung tanggal yang merupakan jumlah bulan yang ditentukan jauh dari tanggal yang ditentukan.

public:
 override DateTime AddMonths(DateTime time, int months);

public override DateTime AddMonths (DateTime time, int months);

override this.AddMonths : DateTime * int -> DateTime

Public Overrides Function AddMonths (time As DateTime, months As Integer) As DateTime

Parameter

time

DateTime

yang DateTime akan ditambahkan months.

months

Int32

Jumlah bulan yang akan ditambahkan.

Mengembalikan

DateTime

DateTime Baru yang dihasilkan dari penambahan jumlah bulan yang ditentukan ke time parameter .

Pengecualian

ArgumentException

Hasilnya berada di luar rentang yang DateTimedidukung dari .

ArgumentOutOfRangeException

months kurang dari -120000 atau lebih besar dari 120000.

-atau-

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 menjadi hari terakhir yang valid pada bulan yang dihasilkan dari tahun yang dihasilkan. Bagian tahun dari hasil DateTime terpengaruh jika bulan yang dihasilkan berada di luar tahun dari 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 yang dihasilkan DateTime tetap sama dengan yang ditentukan DateTime.

Misalnya, jika bulan yang ditentukan adalah Oktober, yang memiliki 31 hari, hari yang ditentukan adalah hari ketiga puluh pertama bulan itu months , dan nilai parameter adalah 6, tahun yang dihasilkan adalah satu lebih dari tahun yang ditentukan, bulan yang dihasilkan adalah April, dan hari yang dihasilkan adalah hari ketiga puluh, yang merupakan hari terakhir pada bulan April.

Jika nilai months parameter 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.AddMonths(time, months), time.Kind);

returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)