DateAndTime.TimeSerial(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 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 -> DateTime

Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

Parameter

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

DateTime

Date Nilai yang mewakili jam, menit, dan detik tertentu, dengan informasi tanggal yang ditetapkan relatif terhadap 1 Januari tahun 1.

Pengecualian

ArgumentException

Argumen berada di luar rentang -2.147.483.648 hingga 2.147.483.647

ArgumentOutOfRangeException

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)

Berlaku untuk

Bagikan melalui