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