to_date 函数

  • 项目

适用于：check marked yes Databricks SQL check marked yes Databricks Runtime

返回使用可选格式设置将 expr 转换为日期后的值。

语法

to_date(expr [, fmt] )

参数

  • expr：表示日期的 STRING 表达式。
  • fmt：一个可选格式 STRING 表达式。

返回

一个日期。

如果提供了 fmt，则它必须符合日期/时间模式。

如果未提供 fmt，则此函数是 cast(expr AS DATE) 的同义函数。

如果 fmt 的格式错误或其应用未生成格式正确的日期，则此函数会引发错误。

注意

在 Databricks Runtime 中，如果 spark.sql.ansi.enabled 为 false，则函数返回 NULL 而不是日期格式错误的消息。

示例

> SELECT to_date('2009-07-30 04:17:52');
 2009-07-30
> SELECT to_date('2016-12-31', 'yyyy-MM-dd');
 2016-12-31