Mengembalikan Varian (Tanggal) yang berisi waktu untuk jam, menit, dan detik tertentu.
Sintaks
TimeSerial ( hour, minute, second )
Peringatan Pastikan argumen berada dalam rentang nilai yang benar. Argumen yang tidak valid dapat menghasilkan hasil yang salah.
Sintaks fungsi TimeSerial memiliki argumen ini:
Argumen |
Deskripsi |
jam |
Diperlukan. Varian (Bilangan Bulat). Angka antara 0 (12:00 A.M.) dan 23 (23:00), inklusif, atau ekpresi numerik. |
menit |
Diperlukan. Varian (Bilangan Bulat). Ekpresi numerik apa pun. |
detik |
Diperlukan. Varian (Bilangan Bulat). Ekpresi numerik apa pun. |
Keterangan
Untuk menentukan waktu, seperti 11:59:59, rentang angka untuk setiap argumen TimeSerial harus berada dalam rentang normal untuk unit; yaitu, 0–23 untuk jam dan 0–59 selama menit dan detik. Namun, Anda juga dapat menentukan waktu relatif untuk setiap argumen menggunakan ekspresi numerik apa pun yang menunjukkan jumlah jam, menit, atau detik sebelum atau sesudah waktu tertentu. Contoh berikut ini menggunakan ekspresi dan bukan angka waktu absolut. Fungsi TimeSerial mengembalikan waktu selama 15 menit sebelum (-15) enam jam sebelum siang hari (12 - 6), atau 5:45:00 A.M.
TimeSerial(12 - 6, -15, 0)
Ketika argumen melebihi rentang normal untuk argumen tersebut, argumen akan naik ke unit yang lebih besar berikutnya sebagaimana diperlukan. Misalnya, jika Anda menentukan 75 menit, itu dievaluasi sebagai satu jam dan 15 menit. Jika argumen tunggal berada di luar rentang -32.768 hingga 32.767, kesalahan terjadi. Jika waktu yang ditentukan oleh tiga argumen menyebabkan tanggal berada di luar rentang tanggal yang dapat diterima, kesalahan terjadi.
Contoh kueri
Ekspresi |
Hasil |
SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); |
Mengembalikan "Waktu" yang terdiri dari jam, menit, dan detik yang ditentukan yang dimasukkan dalam argumen fungsi dan ditampilkan di kolom NewTime. Hasil: "6:12:10 PM". |
Contoh VBA
Catatan: Contoh yang mengikuti demonstrasi penggunaan fungsi ini dalam modul Visual Basic for Applications (VBA). Untuk informasi selengkapnya tentang bekerja dengan VBA, pilih Referensi Pengembang di daftar turun bawah di samping Cari dan masukkan satu istilah atau lebih di kotak pencarian.
Contoh ini menggunakan fungsi TimeSerial untuk mengembalikan waktu untuk jam, menit, dan detik yang ditentukan.
Dim MyTime
MyTime = TimeSerial(16, 35, 17) ' MyTime contains serial representation of 4:35:17 PM.