DateAndTime.DateSerial(Int32, Int32, Int32) Metode

Referensi

Definisi

Ruang nama:: Microsoft.VisualBasic

Rakitan:: Microsoft.VisualBasic.Core.dll

Rakitan:: Microsoft.VisualBasic.dll

Sumber:: DateAndTime.vb

Sumber:: DateAndTime.vb

Sumber:: DateAndTime.vb

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 -> DateTime

Public Function DateSerial (Year As Integer, Month As Integer, Day As Integer) As DateTime

Parameter

Year: Int32

Wajib diisi. 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 "Keterangan". Jika Year kurang dari 1, itu dikurangi dari tahun berjalan.

Month: Int32

Wajib diisi. Ekspresi bilangan bulat dari 1 hingga 12. Namun, nilai di luar rentang ini juga diterima. Nilai Month diimbangi dengan 1 dan diterapkan pada Januari tahun terhitung. 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

Wajib diisi. Ekspresi bilangan bulat dari 1 hingga 31. Namun, nilai di luar rentang ini juga diterima. Nilai Day diimbangi dengan 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 yang dihitung.

Jika Day adalah 0, hasilnya adalah hari terakhir dari bulan sebelumnya.

Jika Day -1, hasilnya adalah hari yang dipenultiasi pada bulan sebelumnya.

Jika Day melewati akhir bulan ini, hasilnya adalah hari yang sesuai pada bulan berikutnya. Misalnya, jika Month adalah 4 dan Day 31, hasilnya adalah 1 Mei.

Mengembalikan

DateTime

Nilai yang mewakili tahun, bulan, dan hari yang ditentukan, dengan informasi waktu 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 Year argumen ditafsirkan 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 Date yang mewakili hari sebelum hari pertama Maret dalam tahun 10 tahun sebelum tahun ini; 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, itu diterapkan ke unit yang lebih besar berikutnya yang sesuai. 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 beban DateTime untuk mengisi variabel menggunakan kombinasi komponen yang Date diinginkan. Contoh berikut diatur NewDateTime ke 6 Mei 1978 pada sepersepuluh detik sebelum pukul 08.30 di pagi hari:

Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)

Berlaku untuk

Bagikan melalui