unix_timestamp 関数

  • [アーティクル]

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

現在または指定された時刻の UNIX タイムスタンプを返します。

構文

unix_timestamp([expr [, fmt] ] )

引数

  • expr: 有効な datetime 形式のオプションの DATE、TIMESTAMP、または STRING 式。
  • fmt: expr が文字列である場合、形式を指定するオプションの文字列式。

戻り値

BIGINT 値。

引数が指定されていない場合、既定値は現在の timestamp です。 expr が DATE または TIMESTAMP の場合、fmt は無視されます。 expr が文字列の場合、fmt は UNIX timestamp を計算する前に、文字列を TIMESTAMP に変換するために使用されます。

既定の fmt 値は 'yyyy-MM-dd HH:mm:ss' です。

有効な日付と時刻の書式パターンについては、Datetime パターンに関するページを参照してください。

fmt または expr が無効である場合、関数はエラーを返します。

注意

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

例

> SELECT unix_timestamp();
 1476884637
> SELECT unix_timestamp('2016-04-08', 'yyyy-MM-dd');
 1460041200