DateAndTime.TimeSerial(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 menunjukkan jam, menit, dan detik tertentu, dengan informasi tanggal yang ditetapkan relatif terhadap 1 Januari tahun 1.
public:
static DateTime TimeSerial(int Hour, int Minute, int Second);public static DateTime TimeSerial (int Hour, int Minute, int Second);static member TimeSerial : int * int * int -> DateTimePublic Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTimeParameter
- Hour
- Int32
Wajib diisi. Ekspresi bilangan bulat dari 0 hingga 23. Namun, nilai di luar rentang ini juga diterima.
- Minute
- Int32
Wajib diisi. Ekspresi bilangan bulat dari 0 hingga 59. Namun, nilai di luar rentang ini juga diterima. Nilai Minute ditambahkan ke jam terhitung, sehingga nilai negatif menentukan menit sebelum jam tersebut.
- Second
- Int32
Wajib diisi. Ekspresi bilangan bulat dari 0 hingga 59. Namun, nilai di luar rentang ini juga diterima. Nilai Second ditambahkan ke menit terhitung, sehingga nilai negatif menentukan detik sebelum menit tersebut.
Mengembalikan
Date Nilai yang mewakili jam, menit, dan detik tertentu, dengan informasi tanggal yang ditetapkan relatif terhadap 1 Januari tahun 1.
Pengecualian
Argumen berada di luar rentang -2.147.483.648 hingga 2.147.483.647
Waktu yang dihitung kurang dari negatif 24 jam.
Contoh
Contoh berikut menggunakan TimeSerial fungsi untuk mengembalikan waktu untuk jam, menit, dan detik yang ditentukan.
Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)
Keterangan
Contoh berikut menunjukkan nilai argumen negatif, nol, dan positif. Fungsi mengembalikan TimeSerial waktu yang mewakili 15 menit sebelum tiga jam sebelum siang, atau pukul 08.45.00.
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
Jika salah satu Minute atau Second melebihi rentang normalnya, maka akan diterapkan ke unit yang lebih besar berikutnya yang sesuai. Misalnya, jika Anda menentukan 75 menit, itu dievaluasi sebagai satu jam dan 15 menit.
TimeSerial mengurangi total detik modulo 86.400, yang merupakan jumlah detik dalam sehari. Oleh karena itu, waktu yang dikembalikan selalu antara 00:00:00 dan 23:59:59.
Jenis Date data mencakup komponen tanggal.
TimeSerial mengatur semua ini ke 1, sehingga nilai yang dikembalikan mewakili hari pertama tahun 1. Namun, jika nilai argumen menyebabkan waktu terhitung melebihi 24 jam, hari akan dinaikkan seperlunya. Dalam contoh berikut, nilai Hour dan Minute menghasilkan waktu gabungan lebih dari 24 jam.
MsgBox(TimeSerial(23, 75, 0))
' The preceding statement displays "1/2/0001 12:15:00 AM".
Jika nilai argumen menghasilkan waktu terhitung negatif, informasi tanggal diatur ke 1/1/0001 dan informasi waktu disesuaikan menjadi antara 00:00:00 dan 23:59:59. Namun, jika waktu yang dihitung kurang dari negatif 24 jam, kesalahan ArgumentOutOfRangeException terjadi.
Karena setiap Date nilai didukung oleh System.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 ditetapkan newDateTime ke 6 Mei 1978 pada sepersepuluh detik sebelum pukul 8:30 di pagi hari:
Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
