EastAsianLunisolarCalendar.AddMonths(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 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
- months
- Int32
Jumlah bulan yang akan ditambahkan.
Mengembalikan
DateTime Baru yang dihasilkan dari penambahan jumlah bulan yang ditentukan ke time
parameter .
Pengecualian
Hasilnya berada di luar rentang yang DateTimedidukung dari .
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)