try_to_timestamp：安全时间戳转换

速查结论

try_to_timestamp(timestamp_str[, fmt]) 是 Spark SQL 中用于安全解析时间戳的函数。与 to_timestamp 不同，当输入字符串格式不匹配时，它返回 NULL 而不是抛出异常，非常适合处理不规整的日志数据或用户输入。

语法

try_to_timestamp(timestamp_str[, fmt])

参数说明

参数	说明
timestamp_str	待解析为时间戳的字符串
fmt	可选，日期时间格式模式。参见日期时间模式。省略时使用默认转换规则

返回值：解析后的时间戳。输入无效时返回 NULL。结果数据类型与配置 spark.sql.timestampType 一致。

Since: 3.4.0

示例

默认格式解析

-- 默认格式 'yyyy-MM-dd HH:mm:ss'
SELECT try_to_timestamp('2016-12-31 00:12:00');
-- 结果: 2016-12-31 00:12:00

指定格式解析

-- 指定日期格式，时间部分默认为 00:00:00
SELECT try_to_timestamp('2016-12-31', 'yyyy-MM-dd');
-- 结果: 2016-12-31 00:00:00

无效输入的优雅处理

-- 格式不匹配：返回 NULL 而不报错
SELECT try_to_timestamp('foo', 'yyyy-MM-dd');
-- 结果: NULL

-- 对比 to_timestamp：格式不匹配会报错
SELECT to_timestamp('foo', 'yyyy-MM-dd');
-- 报错: You may get a different result due to the upgrading to Spark >= 3.0

try_to_timestamp vs to_timestamp vs to_date 对比

函数	无效输入	返回值类型	适用场景
try_to_timestamp(str, fmt)	返回 NULL	Timestamp	数据不规整、格式可能不匹配
to_timestamp(str, fmt)	返回 NULL (Spark 3.0+) 或报错	Timestamp	数据规整、格式确定
to_date(str, fmt)	返回 NULL (Spark 3.0+) 或报错	Date	只需日期部分

-- try_to_timestamp: 安全解析，始终返回 NULL 而非报错
SELECT try_to_timestamp('bad_data', 'yyyy-MM-dd');
-- 结果: NULL

-- to_timestamp: Spark 3.0+ 也返回 NULL，但有警告
SELECT to_timestamp('bad_data', 'yyyy-MM-dd');
-- 结果: NULL（含警告）

选型建议：

• ETL 清洗不规整数据：用 try_to_timestamp，语义明确表示"尝试解析"
• 数据已通过校验、格式确定：用 to_timestamp

常见报错与避坑指南

格式模式不匹配

fmt 参数必须与 timestamp_str 的实际格式一致，否则返回 NULL。

-- 错误写法：格式不匹配
SELECT try_to_timestamp('2016/12/31', 'yyyy-MM-dd');
-- 结果: NULL（'/' 和 '-' 不匹配）

-- 正确写法：格式匹配输入
SELECT try_to_timestamp('2016/12/31', 'yyyy/MM/dd');
-- 结果: 2016-12-31 00:00:00

result 类型由配置决定

结果数据类型与 spark.sql.timestampType 配置值一致（TIMESTAMP_NTZ 或 TIMESTAMP），不同配置下结果行为可能不同。

-- 查看当前配置
SET spark.sql.timestampType;
-- TIMESTAMP_NTZ 或 TIMESTAMP

📱关注公众号

「数据仓库技术」文章同步更新，不错过每一篇干货

💬加群交流

备注「数据仓库技术」加入社群，每日一道大厂SQL真题