DateAndTime.DateSerial(Int32, Int32, 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 nilai yang Date mewakili tahun, bulan, dan hari yang ditentukan, dengan informasi waktu yang diatur ke tengah malam (00:00:00).
public:
static DateTime DateSerial(int Year, int Month, int Day);public static DateTime DateSerial(int Year, int Month, int Day);static member DateSerial : int * int * int -> DateTimePublic Function DateSerial (Year As Integer, Month As Integer, Day As Integer) As DateTimeParameter
- Year
- Int32
Required. Ekspresi bilangan bulat dari 1 hingga 9999. Namun, nilai di bawah rentang ini juga diterima. Jika Year adalah 0 hingga 99, itu ditafsirkan sebagai antara 1930 dan 2029, seperti yang dijelaskan di bagian "Komentar". Jika Year kurang dari 1, itu dikurangi dari tahun saat ini.
- Month
- Int32
Required. Ekspresi bilangan bulat dari 1 hingga 12. Namun, nilai di luar rentang ini juga diterima. Nilai Month diimbangi oleh 1 dan diterapkan pada Januari tahun yang dihitung. Dengan kata lain, (Month - 1) ditambahkan ke Januari. Tahun dihitung ulang jika perlu. Hasil berikut mengilustrasikan efek ini:
Jika Month adalah 1, hasilnya adalah Januari dari tahun yang dihitung.
Jika Month adalah 0, hasilnya adalah Desember dari tahun sebelumnya.
Jika Month -1, hasilnya adalah November dari tahun sebelumnya.
Jika Month 13, hasilnya adalah Januari tahun berikutnya.
- Day
- Int32
Required. Ekspresi bilangan bulat dari 1 hingga 31. Namun, nilai di luar rentang ini juga diterima. Nilai Day diimbangi oleh 1 dan diterapkan ke hari pertama bulan terhitung. Dengan kata lain, (Day - 1) ditambahkan ke bulan pertama. Bulan dan tahun dihitung ulang jika perlu. Hasil berikut mengilustrasikan efek ini:
Jika Day adalah 1, hasilnya adalah hari pertama dari bulan terhitung.
Jika Day adalah 0, hasilnya adalah hari terakhir dari bulan sebelumnya.
Jika Day -1, hasilnya adalah hari penultimate bulan sebelumnya.
Jika Day melewati akhir bulan saat ini, hasilnya adalah hari yang sesuai pada bulan berikutnya. Misalnya, jika Month adalah 4 dan Day 31, hasilnya adalah 1 Mei.
Mengembalikan
Nilai yang mewakili tahun, bulan, dan hari yang ditentukan, dengan informasi waktu yang diatur ke tengah malam (00:00:00).
Contoh
Contoh ini menggunakan DateSerial fungsi untuk mengembalikan tanggal untuk tahun, bulan, dan hari yang ditentukan.
' DateSerial returns the date for a specified year, month, and day.
Dim aDate As Date
' Variable aDate contains the date for February 12, 1969.
aDate = DateSerial(1969, 2, 12)
Console.WriteLine(aDate)
' The following example uses DateSerial to determine and display
' the last day of the previous month.
' First, establish a starting date.
Dim startDate = #1/23/1994#
' The 0 for the day represents the last day of the previous month.
Dim endOfLastMonth = DateSerial(startDate.Year, startDate.Month, 0)
Console.WriteLine("Last day in the previous month: " & endOfLastMonth)
' The following example finds and displays the day of the week that the
' 15th day of the following month will fall on.
Dim fifteenthsDay = DateSerial(Today.Year, Today.Month + 1, 15)
Console.WriteLine("The 15th of next month is a {0}", fifteenthsDay.DayOfWeek)
Keterangan
Nilai dua digit untuk argumen ditafsirkan Year berdasarkan pengaturan komputer yang ditentukan pengguna. Pengaturan default adalah bahwa nilai dari 0 hingga 29 ditafsirkan sebagai tahun 2000-2029, dan nilai dari 30 hingga 99 ditafsirkan sebagai tahun 1930-1999. Untuk menandakan semua tahun lainnya, gunakan tahun empat digit, misalnya, 1924.
Contoh berikut menunjukkan nilai argumen negatif, nol, dan positif. Di sini, DateSerial fungsi mengembalikan yang Date mewakili hari sebelum hari pertama Maret pada tahun 10 tahun sebelum tahun berjalan; dengan kata lain, hari terakhir Februari sepuluh tahun yang lalu.
Dim EndFeb As Date = DateSerial(-10, 3, 0)
Jika salah satu Month atau Day melebihi rentang normalnya, maka diterapkan ke unit yang lebih besar berikutnya sebagaimana mewajarkannya. Misalnya, jika Anda menentukan 32 hari, itu dievaluasi sebagai satu bulan dan dari satu hingga empat hari, tergantung pada nilai Month. Jika Year lebih besar dari 9999, atau jika ada argumen di luar rentang -2.147.483.648 hingga 2.147.483.647, kesalahan ArgumentException terjadi. Jika tanggal yang ditentukan oleh tiga argumen lebih awal dari 00:00:00 pada 1 Januari tahun 1, atau lebih baru dari 23:59:59 pada 31 Desember 9999, kesalahan ArgumentOutOfRangeException terjadi.
Jenis Date data mencakup komponen waktu.
DateSerial mengatur semua ini ke 0, sehingga nilai yang dikembalikan mewakili awal hari terhitung.
Karena setiap Date nilai didukung oleh DateTime struktur, metodenya memberi Anda opsi tambahan dalam merakit Date nilai. Misalnya, Anda dapat menggunakan salah satu konstruktor yang kelebihan DateTime beban untuk mengisi variabel menggunakan kombinasi komponen yang Date diinginkan. Contoh berikut diatur NewDateTime ke 6 Mei 1978 pada sepersepuluh detik sebelum 8:30 di pagi hari:
Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
