Fungsi CURRENT_MICROS mengembalikan waktu saat ini dalam zona waktu tertentu sebagai nilai BIGINT yang mewakili mikrodetik.
Sintaksis
BIGINT CURRENT_MICROS([STRING <time_zone>])
-- Contoh.
-- Mengembalikan 62747524000.
SELECT CURRENT_MICROS('Asia/Shanghai');Parameter
time_zone: Opsional. Nilai STRING yang menentukan zona waktu. Contoh: Asia/Shanghai, UTC+08:00, atau +8. Jika parameter ini tidak disertakan, fungsi akan menggunakan zona waktu sesi atau proyek saat ini sebagai nilai default.
Zona waktu proyek default adalah UTC+08:00.
Nilai pengembalian
Sebuah nilai BIGINT yang mewakili waktu dalam mikrodetik. Jika parameter input adalah NULL, fungsi mengembalikan NULL.
Contoh
Dalam contoh berikut, zona waktu proyek saat ini adalah Asia/Shanghai dan waktunya adalah 2025-09-24 17:25:18.381.
Contoh 1: Dapatkan waktu di zona waktu sesi atau proyek saat ini.
-- Mengembalikan nilai waktu untuk zona waktu sesi/proyek saat ini. -- Mengembalikan 62718381000. SELECT CURRENT_MICROS();Contoh 2: Dapatkan waktu saat ini di zona waktu Bangladesh (UTC+06:00).
-- Mengembalikan 55518381000. SELECT CURRENT_MICROS('Asia/Dhaka'); -- Ini adalah pernyataan setara. Mengembalikan 55518381000. SELECT CURRENT_MICROS('UTC+06:00'); -- Ini adalah pernyataan setara. Mengembalikan 55518381000. SELECT CURRENT_MICROS('+06');Contoh 3: Berikan NULL sebagai parameter.
-- Mengembalikan NULL. SELECT CURRENT_MICROS(NULL);Contoh 4: Konversikan format waktu.
Gunakan fungsi FORMAT_TIME untuk mengonversi nilai
BIGINTyang dikembalikan menjadiSTRINGyang diformat.-- Mengembalikan waktu di zona waktu Asia/Shanghai. -- Mengembalikan 17:25:18.381. SELECT FORMAT_TIME(CURRENT_MICROS('Asia/Shanghai'),'%H:%M:%S.ff3'); -- Mengembalikan waktu di zona waktu Asia/Dhaka. -- Mengembalikan 15:25:18. SELECT FORMAT_TIME(CURRENT_MICROS('Asia/Dhaka'),'%H:%M:%S');
Fungsi terkait
CURRENT_MICROS adalah fungsi waktu. Untuk informasi lebih lanjut tentang fungsi terkait komputasi dan konversi tanggal, lihat Fungsi Tanggal.