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