Fungsi TimeSerial

Berlaku Untuk
Access untuk Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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 (00.00) dan 23 (23.00), inklusif, atau ekspresi 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 bisa menentukan waktu relatif untuk setiap argumen menggunakan ekspresi numerik apa pun yang mewakili beberapa 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.

Memilih fungsi tanggal yang benar