Konvertierungsfunktionen¶

Diese Funktionsfamilie kann verwendet werden, um einen Ausdruck eines beliebigen Snowflake-Datentyps in einen anderen Datentyp zu konvertieren.

Liste der Funktionen¶


Unterkategorie	Funktion	Anmerkungen
Jeder Datentyp	CAST, ::
Jeder Datentyp	TRY_CAST	Fehlerbehandlungsversion von CAST.
Text/Zeichen/Binärdatentypen	TO_CHAR , TO_VARCHAR
	TO_BINARY
	TRY_TO_BINARY	Fehlerbehandlungsversion von TO_BINARY
Numerische Datentypen	TO_DECFLOAT
	TO_DECIMAL , TO_NUMBER , TO_NUMERIC
	TO_DOUBLE
	TRY_TO_DECFLOAT	Fehlerbehandlungsversion von TO_DECFLOAT.
	TRY_TO_DECIMAL, TRY_TO_NUMBER, TRY_TO_NUMERIC	Fehlerbehandlungsversionen von TO_DECIMAL, TO_NUMBER und so weiter.
	TRY_TO_DOUBLE	Fehlerbehandlungsversion von TO_DOUBLE.
Boolescher Datentyp	TO_BOOLEAN
Boolescher Datentyp	TRY_TO_BOOLEAN	Fehlerbehandlungsversion von TO_BOOLEAN.
Datentypen für Datum und Uhrzeit	TO_DATE , DATE
	TO_TIME , TIME
	TO_TIMESTAMP / TO_TIMESTAMP_*
	TRY_TO_DATE	Fehlerbehandlungsversion von TO_DATE.
	TRY_TO_TIME	Fehlerbehandlungsversion von TO_TIME.
	TRY_TO_TIMESTAMP / TRY_TO_TIMESTAMP_*	Fehlerbehandlungsversionen von TO_TIMESTAMP und so weiter.
Semistrukturierte Datentypen	TO_ARRAY
	TO_OBJECT
	TO_VARIANT
Datentypen für Geodaten	TO_GEOGRAPHY
	TRY_TO_GEOGRAPHY	Fehlerbehandlungsversion von TO_GEOGRAPHY
	ST_GEOGFROMGEOHASH
	ST_GEOGPOINTFROMGEOHASH
	ST_GEOGRAPHYFROMWKB
	ST_GEOGRAPHYFROMWKT
	TO_GEOMETRY
	TRY_TO_GEOMETRY	Fehlerbehandlungsversion von TO_GEOMETRY
	ST_GEOMETRYFROMWKB
	ST_GEOMETRYFROMWKT

Konvertierungsfunktionen zur Fehlerbehandlung¶

Konvertierungsfunktionen mit einem Präfix TRY_ sind spezielle Versionen ihrer jeweiligen Konvertierungsfunktionen. Wenn die Konvertierung nicht ausgeführt werden kann, lösen diese Funktionen keinen Fehler aus, sondern geben einen NULL-Wert zurück:

Diese Funktionen unterstützen nur Zeichenfolgenausdrücke (d. h. Datentyp VARCHAR oder CHAR) als Eingabe.

Wichtig

Diese Konvertierungsfunktionen zur Fehlerbehandlung sind für Situationen optimiert, in denen Konvertierungsfehler relativ selten auftreten:

Wenn es keine (oder nur sehr wenige) Fehler gibt, sollten sie keine sichtbaren Auswirkungen auf die Leistung haben.
Bei einer großen Anzahl von Konvertierungsfehlern kann die Verwendung dieser Funktionen zu deutlichen Leistungseinbußen führen. Auch bei der Verwendung mit dem VARIANT-Typ können einige Operationen zu Leistungseinbußen führen.

Numerische Formate in Konvertierungsfunktionen¶

Die Funktionen TO_DECIMAL , TO_NUMBER , TO_NUMERIC und TO_DOUBLE akzeptieren einen optionalen Parameter, der das Format der Eingabezeichenfolge angibt, wenn der Eingabeausdruck eine Zeichenfolge ergibt. Weitere Informationen zu den Werten, die dieser Parameter haben kann, finden Sie unter SQL-Formatmodelle.

Datums- und Uhrzeitformate in Konvertierungsfunktionen¶

Mit den folgenden Funktionen können Sie das erwartete Datums-, Uhrzeit- oder Zeitstempelformat zum Analysieren (Parsen) oder Erzeugen einer Zeichenfolge angeben:

Sie geben das Format in einem optionalen Argument an, und verwenden Sie die folgenden Elemente (ohne Berücksichtigung der Groß-/Kleinschreibung) zur Beschreibung des Formats:


Formatelement	Beschreibung
`YYYY`	Vierstellige Jahresangabe des Typs ^[1].
`YY`	Zweistellige Jahresangabe des Typs ^[1], gesteuert durch den Sitzungsparameter TWO_DIGIT_CENTURY_START. Wenn Sie zum Beispiel `1980` einstellen, werden die Werte von `79` und `80` als `2079` bzw. `1980` analysiert.
`Y`	Ein- oder zweistellige ^[2] Jahresangabe ohne führende Nullen, gesteuert durch den TWO_DIGIT_CENTURY_START-Sitzungsparameter. Wenn der Parameter beispielsweise auf `1990` gesetzt ist, werden die Werte `2005` und `1991` als `5` und entsprechend `91` serialisiert.
`MM`	Zweistellige Monatsangabe des Typs ^[1] (`01` = Januar und so weiter).
`MO`	Ein- oder zweistellige ^[2] Monatsangabe ohne führende Nullen (`1` = Januar und so weiter).
`MON`	Abgekürzter Monatsname ^[3].
`MMMM`	Vollständiger Monatsname ^[3].
`DD`	Zweistellige Angabe für Tag des Monats des Typs ^[1] (`31`).
`D`	Ein- oder zweistellige ^[2] Angabe für Tag des Monats ohne führende Nullen (`1` bis `31`).
`DY`	Abgekürzter Wochentag.
`HH24`	Zweistellige Angabe ^[1] für Stunde (`00` bis `23`). Sie dürfen nicht `AM` / `PM` oder `A` / `P` angeben.
`HH12`	Zweistellige Angabe ^[1] für Stunde (`01` bis `12`). Sie können `AM` / `PM` oder `A` / `P` angeben.
`H24`	Ein- oder zweistellige Angabe ^[2] für Stunde ohne führende Nullen (`0` bis `23`). Sie dürfen nicht `AM` / `PM` oder `A` / `P` angeben.
`H12`	Ein- oder zweistellige Angabe ^[2] für Stunde ohne führende Nullen (`1` bis `12`). Sie können `AM` / `PM` oder `A` / `P` angeben.
`AM`, `PM`	Ante Meridiem (`AM`) / Post Meridiem (`PM`). Verwenden Sie diese Angabe nur mit `HH12` und code:`H12` (nicht mit `HH24` oder `H24`).
`P`	Ante Meridiem (`A`) / Post Meridiem (`P`). Verwenden Sie diese Angabe nur mit `HH12` und code:`H12` (nicht mit `HH24` oder `H24`).
`HH`	Synonym für `HH24`.
`H`	Synonym für `H24`.
`MI`	Zweistellige Minutenangabe des Typs ^[1] (`00` bis `59`).
`ME`	Ein- oder zweistellige Angabe ^[2] für Minute ohne führende Nullen (`0` bis `59`).
`SS`	Zweistellige Sekundenangabe des Typs ^[1] (`00` bis `59`).
`S`	Ein- oder zweistellige Angabe :sup:` [2]` für Sekunde ohne führende Nullen (`0` bis `59`).
`FF[0-9]`	Sekundenbruchteile mit der Genauigkeit `0` (Sekunden) bis `9` (Nanosekunden), z. B. `FF`, `FF0`, `FF3`, `FF9`. Die Angabe von `FF` entspricht `FF9` (Mikrosekunden).
`TZH:TZM`, `TZHTZM`, `TZH`	Zweistellige Zeitzonenstunde und -minute des Typs ^[1], Offset von UTC. Kann `+`/`-` als Vorzeichen erhalten.
`UUUU`	Vierstellige Jahreszahl im ISO-Format, die für Jahre v. u. Z. negativ ist.

_{[1] Die Anzahl der Ziffern beschreibt die Ausgabe, die beim Serialisieren von Werten in Text erzeugt wird. Beim Parsen von Text akzeptiert Snowflake Werte bis zur angegebenen Anzahl von Ziffern. Zum Beispiel kann die Nummer für einen Tag aus ein oder zwei Ziffern bestehen.}

_{[2] Die Anzahl der Ziffern beschreibt die Ausgabe, die beim Serialisieren von Werten in Text erzeugt wird. Analysieren wird nicht unterstützt. Wenn das Analysieren erforderlich ist, verwenden Sie ein gleichwertiges Format, das führende Nullen enthält. Diese Formatelemente werden in BCR Bundle 2026_03} aktiviert.

_{[3] Für das MON-Formatelement ist die Ausgabe, die bei der Serialisierung von Werten in Text erzeugt wird, der abgekürzte Monatsname. Für das MMMM-Formatelement ist die Ausgabe, die bei der Serialisierung von Werten in Text erzeugt wird, der vollständige Monatsname. Beim Analysieren von Text akzeptiert Snowflake die dreistellige Abkürzung oder den vollständigen Monatsnamen für MON und MMMM. Beispielsweise werden „Januar“ oder „Jan“, „Februar“ oder „Feb“ usw. beim Analysieren von Text akzeptiert.}

Bemerkung

Bei Verwendung eines reinen Datumsformats wird davon ausgegangen, dass die zugehörige Uhrzeit Mitternacht an diesem Tag ist.
Alles, was im Format zwischen doppelten Anführungszeichen oder anderen als den oben genannten Elementen liegt, wird analysiert und formatiert, ohne interpretiert zu werden. Snowflake empfiehlt, stets Literalzeichen in doppelte Anführungszeichen zu setzen (z. B. "T", "EST", "Z"), um sicherzustellen, dass sie als Literale behandelt werden.
Weitere Informationen zu gültigen Bereichen, die Anzahl der Ziffern und zu bewährten Verfahren finden Sie unter Zusätzliche Informationen zur Verwendung von Datums-, Uhrzeit- und Zeitstempelformaten.

Nutzungshinweise¶

Alles, was im Format zwischen doppelten Anführungszeichen oder anderen als den oben genannten Elementen liegt, wird analysiert und formatiert, ohne interpretiert zu werden.

Beispiele¶

Konvertieren einer Zeichenfolge in ein Datum unter Verwendung des spezifischen Eingabeformats dd/mm/yyyy. Das Anzeigeformat für Datumswerte in der Ausgabe wird durch den Sitzungsparameter DATE_OUTPUT_FORMAT bestimmt (Standard: YYYY-MM-DD).

SELECT TO_DATE('3/4/2024', 'dd/mm/yyyy');

+-----------------------------------+
| TO_DATE('3/4/2024', 'DD/MM/YYYY') |
|-----------------------------------|
| 2024-04-03                        |
+-----------------------------------+

Konvertieren eines Datums in eine Zeichenfolge und Angeben eines Datumsausgabeformats von mon dd, yyyy.

SELECT TO_VARCHAR('2024-04-05'::DATE, 'mon dd, yyyy');

+------------------------------------------------+
| TO_VARCHAR('2024-04-05'::DATE, 'MON DD, YYYY') |
|------------------------------------------------|
| Apr 05, 2024                                   |
+------------------------------------------------+

Binärformate in Konvertierungsfunktionen¶

TO_CHAR , TO_VARCHAR und TO_BINARY akzeptieren ein optionales Argument, das das erwartete Format zum Parsen oder Erstellen einer Zeichenfolge angibt.

Das Format kann eine der folgenden Zeichenfolgen sein (Groß-/Kleinschreibung wird nicht berücksichtigt):

HEX

BASE64

UTF-8

Weitere Informationen zu diesen Dateiformaten finden Sie unter Übersicht der unterstützten Binärformate.

Beispiele für die Verwendung dieser Formate finden Sie im Abschnitt „Beispiele“ von Eingabe und Ausgabe von Binärdaten.