to_date 函数

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime

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

语法

to_date(expr [, fmt] )

参数

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

返回

一个日期。

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

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

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

注意

在 Databricks Runtime 中,如果 spark.sql.ansi.enabledfalse,则函数返回 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