to_date
関数
適用対象: Databricks SQL Databricks Runtime
任意の書式設定を使用した日付への expr
キャストを返します。
構文
to_date(expr [, fmt] )
引数
expr
: 日付を表す文字列式。- fmt: 書式設定の STRING 式 (省略可能)。
戻り値
DATE 値。
fmt
を指定する場合は、Datetime パターンに準拠している必要があります。
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