to_date函式

適用於:核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime

傳回使用選用格式化轉換為日期的 expr

語法

to_date(expr [, fmt] )

引數

  • expr:代表日期的 STRING 運算式。
  • fmt:選擇性格式 STRING 表達式。

傳回

日期。

如果 fmt 提供,它必須符合 Datetime 模式

如果未 fmt 提供 ,則函式是 的同義字 cast(expr AS DATE)

fmt 形狀錯誤或其應用未產生良好日期,Azure Databricks 會產生錯誤。

常見錯誤條件

注意

在 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

> SELECT to_date('not-a-date');
  Error: CAST_INVALID_INPUT