Freigeben über


unix_timestamp-Funktion

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Gibt den UNIX-Zeitstempel der aktuellen oder angegebenen Zeit zurück.

Syntax

unix_timestamp([expr [, fmt] ] )

Argumente

  • expr: Ein optionaler DATE-, TIMESTAMP- oder STRING-Ausdruck in einem gültigen datetime-Format.
  • fmt: Ein optionaler STRING-Ausdruck, der das Format angibt, wenn expr ein STRING-Element ist.

Gibt zurück

Ein BIGINT-Wert.

Wenn kein Argument angegeben wird, ist der Standardwert der aktuelle Zeitstempel. fmt wird ignoriert, wenn expr ein DATE- oder TIMESTAMP-Element ist. Wenn expr ein STRING-Element ist, wird fmt verwendet, um die Zeichenfolge vor dem Berechnen des Unix-Zeitstempels in ein TIMESTAMP-Element zu übersetzen.

Der fmt-Standardwert ist 'yyyy-MM-dd HH:mm:ss'.

Gültige Muster für Datums- und Uhrzeitformate finden Sie unter Databricks SQL-datetime-Muster.

Wenn fmt oder expr ungültig sind, löst Azure Databricks CANNOT_PARSE_TIMESTAMP aus.

Hinweis

Wenn spark.sql.ansi.enabled in Databricks Runtime false ist, gibt die Funktion NULL anstelle eines Fehlers für falsch formatierte Zeitstempel zurück.

Häufige Fehlerbedingungen

Beispiele

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

> SELECT unix_timestamp('not-a-timestamp', 'yyyy-MM-dd');
  Error: CANNOT_PARSE_TIMESTAMP