使用CURRENT_MICROS函數擷取指定時區的微秒級目前時間-雲原生MaxCompute MaxCompute-阿里雲

CURRENT_MICROS函數用於擷取指定時區目前時間，並返回以微秒為單位的BIGINT類型時間值。

命令格式

BIGINT CURRENT_MICROS([STRING <time_zone>])

-- 標準樣本。
-- 返回62747524000。
SELECT CURRENT_MICROS('Asia/Shanghai');

參數說明

time_zone：可選。指定時區，STRING類型。例如Asia/Shanghai或UTC+08:00或+8。若未指定時區，則預設為當前Session/Project的時區。

說明

若未修改過專案時區，則預設為東八區（UTC+08:00）。

傳回值說明

返回BIGINT類型。預設以微秒為單位表示時間值。若輸入參數為NULL，則返回NULL。

使用樣本

下述樣本中，當前專案時區設定為Asia/Shanghai，時間為2025-09-24 17:25:18.381。

樣本1：預設time_zone，擷取當前Session/Project時區的時間值。

-- 返回當前Session/Project時區的日期。
-- 返回62718381000。
SELECT CURRENT_MICROS();

樣本2：擷取孟加拉國時區(UTC+06:00)的目前時間值。

-- 返回55518381000。
SELECT CURRENT_MICROS('Asia/Dhaka');

-- 等價於上面寫法，返回55518381000。
SELECT CURRENT_MICROS('UTC+06:00');

-- 等價於上面寫法，返回55518381000。
SELECT CURRENT_MICROS('+06');

樣本3：若輸入參數為NULL，則返回NULL。
```
-- 返回NULL。
SELECT CURRENT_MICROS(NULL);
```

樣本4：時間格式轉換。

使用FORMAT_TIME函數將返回的BIGINT類型的時間值，轉換為指定時間格式的STRING類型時間。

-- 返回Asia/Shanghai時區的時間。
-- 返回17:25:18.381。
SELECT FORMAT_TIME(CURRENT_MICROS('Asia/Shanghai'),'%H:%M:%S.ff3');

-- 返回Asia/Dhaka時區的時間。
-- 返回15:25:18。
SELECT FORMAT_TIME(CURRENT_MICROS('Asia/Dhaka'),'%H:%M:%S');

MaxCompute：CURRENT_MICROS

命令格式

參數說明

傳回值說明

使用樣本

相關函數