parse_timestamp-Funktion

Gilt für: Databricks Runtime 18.1 und höher

Wenn expr es sich um eine Zeichenfolge handelt, analysiert sie gemäß TIMESTAMP dem ersten übereinstimmenden Muster in der angegebenen Liste der Formate. Mindestens ein Format kann auf eine vordefinierte Liste von Formaten verweisen. Wenn expr es sich um einen numerischen Typ handelt, analysiert es als Unix-Zeitstempel.

Syntax

parse_timestamp(expr [, { pattern [...] } ])

Argumente

• Ausdruck: Eine Zeichenfolge oder ein numerischer Wert, der in eine TIMESTAMPAnalyse umgewandelt werden soll. Akzeptierte Typen sind:
  • TINYINT SMALLINT INT BIGINT
  • FLOAT, DOUBLE
  • DECIMAL (bis zu 18 Genauigkeit)
  • STRING
• Muster: Eine optionale Liste von Zeitstempelmustern oder ein Verweis auf eine vordefinierte Liste, z #iso8601 . B. oder #rfc3339. Die Zeitstempelmuster müssen eine konstante Zeichenfolge sein. Wenn kein Muster angegeben wird, entspricht es der Angabe #extended.

Rückkehr

Eine TIMESTAMP darstellung der analysierten expr.

Wenn es expr sich um eine Zeichenfolge handelt, wird sie gemäß dem ersten Abgleichsmuster analysiert. Wenn keines der Muster übereinstimmt, löst die Funktion einen Fehler aus.

Wenn dies expr numerisch ist, wird sie immer als Unix-Zeitstempel analysiert.

Ist expr dies NULLder Wert, gibt die Funktion zurück NULL.

Verwenden Sie try_parse_timestamp die Funktion, um anstelle eines Fehlers zurückzugebenNULL, wenn die Analyse fehlschlägt.

Hinweise

• Wenn die Musterliste Werte enthält NULL , werden sie ignoriert. Wenn alle bereitgestellten Muster vorhanden sind NULL, lautet NULLdas Ergebnis .
• Wenn der Zeitstempel mit einem Muster übereinstimmt, das keine Zeitzoneninformationen enthält, wird er in der Sitzungszeitzone analysiert.

Fehlerbedingungen

• CANNOT_PARSE_TIMESTAMP
• DATATYPE_MISMATCH. UNEXPECTED_INPUT_TYPE
• INVALID_PARAMETER_VALUE. MUSTER
• DATATYPE_MISMATCH. NON_FOLDABLE_INPUT

Beispiele

-- Parse timestamp according to default pattern list
> SELECT parse_timestamp('2024-12-09T19:30:01');
 2024-12-09 19:30:01.000

-- Parse a microsecond epoch timestamp using the unix pattern list
> SELECT parse_timestamp('1733772601000000', '#unix');
 2024-12-09 19:30:01.000

-- Bad `expr` that does not match any pattern
> SELECT parse_timestamp('bad input');
  Error: CANNOT_PARSE_TIMESTAMP

-- Use try_parse_timestamp to return NULL instead of error
> SELECT try_parse_timestamp('bad input');
 NULL

-- Extend the default pattern list with custom patterns
> SELECT parse_timestamp(col, "#extended", "dd MMM, yyyy", "MMM d; yy") FROM VALUES ('2024-12-01'), ('02 Dec, 2024'), ('DEC 3; 24') AS t(col)
 2024-12-01 00:00:00.000
 2024-12-02 00:00:00.000
 2024-12-03 00:00:00.000

Musterreferenz

parse_timestamp und try_parse_timestamp die Funktion verwenden einen Mustersatz, der sich auf verschiedene Arten vom standardmäßigen Datums-/Uhrzeitmuster unterscheidet, das von to_timestamp. In der folgenden Tabelle sind alle Mustersymbole aufgeführt, und es wird aufgeführt, ob die einzelnen Mustersymbole unterstützt werden:

Musterlisten

Sie können eine vordefinierte Musterliste anhand des Namens übergeben (z #extended. B. , #iso8601, #unix). Die folgenden Musterlisten sind verfügbar:

• häufig gefundene Muster, die nicht durch einen Standard definiert sind
• iso8601
• rfc1036, rfc1123, rfc2822, rfc3164, rfc3339, rfc4287, rfc5322, rfc5424, rfc6265, rfc7231, rfc822, rfc850, rfc9110, rfc9557
• Unix — Unix-Epochen-Zeitstempel nur
• erweitert — Union aller oben genannten Listen; auch die Standardeinstellung, wenn kein Muster angegeben wird
• extended-dmy – Erweitert mit dmY-gebietsschemaspezifischen Formaten
• extended-mdy – Erweitert mit MDY-gebietsschemaspezifischen Formaten

Verwandte Funktionen

• try_parse_timestamp Funktion
• to_timestamp Funktion
• try_to_timestamp Funktion
• Datetime-Muster
• TIMEZONE