更新时间:2024-01-23 GMT+08:00

to_utc_timestamp

to_utc_timestamp函数用于将timezone所对应的时间戳转换为UTC的时间戳。

命令格式

to_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

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

返回值说明

返回BIGINT类型值。

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

示例代码

返回1692028800000。

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

返回null。

select to_utc_timestamp(null);