更新时间：2026-07-03 GMT+08:00
to_utc_timestamp
to_utc_timestamp函数用于将timezone所对应的时间戳转换为UTC的时间戳。
命令格式
to_utc_timestamp(string timestamp, string timezone)
参数说明
| 参数 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| timestamp | 是 | DATE、TIMESTAMP或STRING | 代表待转换的时间戳。 格式： yyyy-MM-dd yyyy-MM-dd HH:mm:ss yyyy-MM-dd HH:mm:ss.SSS |
| 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, 'PST');
父主题： 日期函数
