更新时间:2023-10-25 GMT+08:00

from_utc_timestamp

from_utc_timestamp函数用于计算将UTC的时间戳转化为timezone所对应的UNIX格式的时间戳。

命令格式

from_utc_timestamp(string timestamp, string timezone)

参数说明

表1 参数说明

参数

是否必选

参数类型

说明

timestamp

DATE

STRING

TINYINT

SMALLINT

INT

BIGINT

代表待转换的时间。

DATE或STRING类型的日期值,或TINYINT、SMALLINT、INT或BIGINT类型的时间戳。

格式:

yyyy-mm-dd

yyyy-mm-dd hh:mi:ss

yyyy-mm-dd hh:mi:ss.ff3

timezone

STRING

代表需要转换的目标时区。

返回值说明

返回TIMESTAMP类型的时间戳。

  • timestamp非DATE或STRING类型时,返回报错,错误信息:data type mismatch;
  • timestamp为DATE或STRING类型,但不符合日期值的入参格式时,返回NULL;
  • timestamp值为NULL时,返回NULL。
  • timezone值为NULL时,返回NULL。

示例代码

返回1691978400000(代表2023-08-14 10:00:00)。

select from_utc_timestamp('2023-08-14 17:00:00','PST');

返回1691917200000(代表2023-08-13 17:00:00)。

select from_utc_timestamp(date '2023-08-14 00:00:00','PST');

返回NULL。

select from_utc_timestamp('2023-08-13',null);