CURRENT_MICROS 関数 overview: マイクロ秒精度時刻 - 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。このパラメーターを省略した場合、関数は現在のセッションまたはプロジェクトのタイムゾーンをデフォルトとして使用します。

説明

デフォルトのプロジェクトタイムゾーンは UTC+08:00 です。

戻り値

マイクロ秒単位の時間を表す BIGINT 値。入力パラメーターが NULL の場合、関数は NULL を返します。

例

次の例では、現在のプロジェクトのタイムゾーンは Asia/Shanghai で、時刻は 2025-09-24 17:25:18.381 です。

例 1: 現在のセッションまたはプロジェクトのタイムゾーンで時刻を取得します。

-- 現在のセッション/プロジェクトのタイムゾーンの時間値を返します。
-- 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 を返します。
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

構文

パラメーター

戻り値

例

関連関数