parse_timestamp 函数

适用于： Databricks Runtime 18.1 及更高版本

如果是 expr 字符串，请根据给定格式列表中的第一个匹配模式将其分析为一个 TIMESTAMP 。 一个或多个格式可以引用预定义的格式列表。 如果 expr 为数值类型，请将其分析为 Unix 时间戳。

Syntax

parse_timestamp(expr [, { pattern [...] } ])

Arguments

• expr：要分析为的 TIMESTAMP字符串或数值。 接受的类型包括：
  • TINYINT、SMALLINT、INT、BIGINT
  • FLOAT、DOUBLE
  • DECIMAL （最高 18 精度）
  • STRING
• pattern：时间戳模式的可选列表或对预定义列表的引用，例如 #iso8601 或 #rfc3339。 时间戳模式必须是 常量字符串。 如果未指定模式，则等效于指定 #extended。

退货

一个 TIMESTAMP 表示已分析 expr的 。

expr如果为字符串，则根据第一个匹配模式对其进行分析。 如果没有任何模式匹配，该函数将引发错误。

如果为 expr 数字，则始终将其解析为 Unix 时间戳。

如果 expr 为 NULL，则函数返回 NULL。

若要在分析失败时返回 NULL 而不是错误，请使用 try_parse_timestamp 函数。

备注

• 如果模式列表包含 NULL 值，则忽略它们。 如果所有提供的模式都是 NULL，则结果是 NULL。
• 如果时间戳与包含无时区信息的模式匹配，则会在会话时区中对其进行分析。

错误条件

• CANNOT_PARSE_TIMESTAMP
• DATATYPE_MISMATCH。UNEXPECTED_INPUT_TYPE
• INVALID_PARAMETER_VALUE。模式
• DATATYPE_MISMATCH。NON_FOLDABLE_INPUT

示例

-- Parse timestamp according to default pattern list
> SELECT parse_timestamp('2024-12-09T19:30:01');
 2024-12-09 19:30:01.000

-- Parse a microsecond epoch timestamp using the unix pattern list
> SELECT parse_timestamp('1733772601000000', '#unix');
 2024-12-09 19:30:01.000

-- Bad `expr` that does not match any pattern
> SELECT parse_timestamp('bad input');
  Error: CANNOT_PARSE_TIMESTAMP

-- Use try_parse_timestamp to return NULL instead of error
> SELECT try_parse_timestamp('bad input');
 NULL

-- Extend the default pattern list with custom patterns
> SELECT parse_timestamp(col, "#extended", "dd MMM, yyyy", "MMM d; yy") FROM VALUES ('2024-12-01'), ('02 Dec, 2024'), ('DEC 3; 24') AS t(col)
 2024-12-01 00:00:00.000
 2024-12-02 00:00:00.000
 2024-12-03 00:00:00.000

模式参考

parse_timestamp和try_parse_timestamp函数使用与标准to_timestamp日期/时间模式不同的模式集。 下表列出了所有模式符号以及是否支持每个符号：

模式列表

可以按名称（例如 #extended， #iso8601） #unix传递预定义的模式列表。 以下模式列表可用：

• 常见 — 通常找不到由标准定义的模式
• iso8601
• rfc1036、 rfc1123、 rfc2822、 rfc3164、 rfc3339、 rfc4287、 rfc5322、 rfc5424、 rfc6265、 rfc7231、 rfc822、 rfc850、 rfc9110、 rfc9557
• unix — 仅 Unix 纪元时间戳
• 扩展 - 上述所有列表的联合;如果未指定模式，则为默认值
• extended-dmy - 使用特定于 DMY 区域设置的格式进行扩展
• extended-mdy - 使用 MDY 区域设置特定格式进行扩展

相关函数

• try_parse_timestamp 函数
• to_timestamp 函数
• try_to_timestamp 函数
• 日期/时间模式
• TIMEZONE