to_timestamp 関数

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

省略可能な書式設定を使用して、タイムスタンプへの expr のキャストを返します。

構文

to_timestamp(expr [, fmt] )

引数

  • expr: タイムスタンプを表す STRING 式。
  • fmt: 書式設定の STRING 式 (省略可能)。

戻り値

TIMESTAMP。

fmt を指定する場合は、Datetime パターンに準拠している必要があります。

fmt が指定されない場合、この関数は cast(expr AS TIMESTAMP) のシノニムです。

fmt の形式が正しくないか、それを適用すると整形式のタイムスタンプにならない場合は、この関数を使用するとエラーが発生します。

expr の形式に誤りがある場合にエラーではなく NULL を返すには、try_to_timestamp を使います。

注意

Databricks Runtime で spark.sql.ansi.enabled が false の場合、この関数は、タイムスタンプの形式に誤りがある場合のエラーではなく、NULL を返します。

例

> SELECT to_timestamp('2016-12-31 00:12:00');
 2016-12-31 00:12:00

> SELECT to_timestamp('2016-12-31', 'yyyy-MM-dd');
 2016-12-31 00:00:00