to_utc_timestamp
to_utc_timestamp函数用于将timezone所对应的时间戳转换为UTC的时间戳。
命令格式
to_utc_timestamp(string timestamp, string timezone)
参数说明
参数 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
timestamp |
是 |
DATE STRING TINYINT SMALLINT INT BIGINT |
代表待处理的时间。 DATE或STRING类型的日期值,或TINYINT、SMALLINT、INT或BIGINT类型的时间戳。
格式:
|
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);