CURRENT_MICROS

命令格式

BIGINT CURRENT_MICROS([STRING <time_zone>])

参数说明

time_zone：可选参数。STRING类型，用于指定时区。若未指定时区，则默认为当前Session/Project的时区。

返回值说明

返回BIGINT类型。默认以微秒为单位表示时间值。若输入参数为NULL，则返回NULL。

使用示例

下述示例中，当前项目时区设置为Asia/Shanghai，时间为2025-08-07 17:08:32.274。

• 示例1：简单示例。

  -- 获取当前Session/Project时区Asia/Shanghai的时间值
  -- 返回61712274000
  SELECT CURRENT_MICROS();
  
  -- 获取Asia/Jakarta时区的时间值
  -- 返回58112274000
  SELECT CURRENT_MICROS("Asia/Jakarta");
  
  --返回 NULL
  SELECT CURRENT_MICROS(NULL);

• 示例2：时间格式转换。

  使用FORMAT_TIME函数将返回的BIGINT类型的时间值，转换为指定时间格式的STRING类型时间。

  -- 返回Asia/Shanghai时区的时间
  -- 返回17:08:32.274
  SELECT format_time(CURRENT_MICROS("Asia/Shanghai"),"%H:%M:%S.ff3");
  
  -- 返回Asia/Jakarta时区的时间
  -- 返回16:08:32.274 
  SELECT format_time(CURRENT_MICROS("Asia/Jakarta"),"%H:%M:%S.ff3");

相关函数

CURRENT_MICROS函数属于时间函数，更多日期计算、日期转换的相关函数请参见日期函数。