FORMAT_TIME

命令格式

STRING FORMAT_TIME(BIGINT <time>, STRING <format>)

参数说明

• time：必填，BIGINT类型。待格式化的值，以微秒为单位用BIGINT类型表示的时间值，您可以用TO_TIME函数进行构造。

  说明

  在MaxCompute 1.0数据类型版本下，如果参数为STRING或DOUBLE类型，则会被隐式转换为BIGINT类型后参与运算。

• format：必填，STRING类型。用于指定输出的时间字符串格式。format目前支持的时间部分的格式元素如下：

  • hh、HH或%H：小时。

  • mi、MI或%M：分钟。

  • ss、SS或%S：秒。

  • ff3：毫秒，单独匹配秒的小数部分，例如用%S.ff3匹配00.123。

  • %E<number>S：秒，小数精度为<number>位，例如用%E3S匹配00.123。

  • %E*S：有完整6位小数精度的秒，例如00.123456。

返回值说明

返回时间格式的STRING类型。当time和format中有任意一个值为NULL时，返回NULL。

使用示例

--返回 13:24:33.000
SELECT FORMAT_TIME(48273000000,'%H:%M:%S.ff3');

--返回 时间是24:33微秒部分为000
SELECT FORMAT_TIME(48273000000,"时间是%M:%S微秒部分为ff3");

--返回 only show 13:24 
SELECT FORMAT_TIME(48273000000,"only show hh:mi");

--返回 15:03:01
SELECT FORMAT_TIME(TO_TIME('15:03:01','hh:mi:ss'),'%H:%M:ss');

--返回 NULL
SELECT FORMAT_TIME(NULL,'%H:%M:%S.ff3');

相关函数

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