Eingabe- und Ausgabeformate für Datum und Uhrzeit¶

Sitzungsparameter für Datum, Uhrzeit und Zeitstempel¶

Mit einer Reihe von Sitzungsparametern wird bestimmt, wie Datums-, Uhrzeit- und Zeitstempeldaten in und aus Snowflake übertragen werden, sowie die Zeitzone, die in den Uhrzeit- und Zeitstempelformaten verwendet wird, die Zeitzonen unterstützen.

Die Parameter können auf Konto-, Benutzer- und Sitzungsebene eingestellt werden. Führen Sie den Befehl SHOW PARAMETERS aus, um die aktuellen Parametereinstellungen anzuzeigen, die für alle Operationen in der aktuellen Sitzung gelten.

Dateiformatoptionen zum Laden/Entladen von Datum, Uhrzeit und Zeitstempel¶

Unabhängig von den Parametern des Ein- und Ausgabeformats bietet Snowflake drei Dateiformatoptionen, die beim Laden von Daten in oder Entladen von Daten aus Snowflake-Tabellen verwendet werden können:

• DATE_FORMAT

• TIME_FORMAT

• TIMESTAMP_FORMAT

Die Optionen können direkt im Befehl COPY oder in einem benannten Stagingbereichs- oder Dateiformatobjekt angegeben werden, auf das im Befehl COPY verwiesen wird. Wenn angegeben, überschreiben diese Optionen die entsprechenden Eingabeformate (beim Laden von Daten) oder Ausgabeformate (beim Entladen von Daten).

Datumsformate¶

Beschreibungen der in den nachstehenden Formaten verwendeten Elemente finden Sie unter In Eingabe- und Ausgabeformaten verwendete Elemente.

Bei Verwendung der Datumsformatierung AUTO sind Striche und Schrägstriche nicht austauschbar. Schrägstriche bedeuten das Format MM/DD/YYYY und Bindestriche das Format YYYY-MM-DD. Zeichenfolgen wie „2019/01/02“ oder „01-02-2019“ werden nicht wie erwartet interpretiert.

Uhrzeitformate¶

Beschreibungen der in den nachstehenden Formaten verwendeten Elemente finden Sie unter In Eingabe- und Ausgabeformaten verwendete Elemente.

Das Formatelement AM ermöglicht Werte mit AM oder PM.

Wenn ein Zeitzonenversatz (z. B. „0800“) in einer Uhrzeit- oder Zeitstempel-Zeichenfolge unmittelbar nach einer Ziffer auftritt, muss der Zeitzonenversatz mit + oder - beginnen. Das Vorzeichen verhindert Mehrdeutigkeit, wenn der Sekundenbruchteil oder der Zeitzonenoffset nicht die maximal zulässige Anzahl von Ziffern enthält. Ohne ein Trennzeichen zwischen der letzten Ziffer der Sekundenbruchteile und der ersten Ziffer der Zeitzone könnte z. B. „1“ in der Zeitangabe „04:04:04.321200“ entweder die letzte Ziffer der Sekundenbruchteile (z. B. 321 Millisekunden) oder die erste Ziffer des Zeitzonenversatzes (z. B. 12 Stunden vor UTC) sein.

Zeitstempelformate¶

Beschreibungen der in den nachstehenden Formaten verwendeten Elemente finden Sie unter In Eingabe- und Ausgabeformaten verwendete Elemente.

Wenn ein Zeitzonenversatz (z. B. „0800“) in einer Uhrzeit- oder Zeitstempel-Zeichenfolge unmittelbar nach einer Ziffer auftritt, muss der Zeitzonenversatz mit + oder - beginnen. Das Vorzeichen verhindert Mehrdeutigkeit, wenn der Sekundenbruchteil oder der Zeitzonenoffset nicht die maximal zulässige Anzahl von Ziffern enthält. Ohne ein Trennzeichen zwischen der letzten Ziffer der Sekundenbruchteile und der ersten Ziffer der Zeitzone könnte z. B. „1“ in der Zeitangabe „04:04:04.321200“ entweder die letzte Ziffer der Sekundenbruchteile (z. B. 321 Millisekunden) oder die erste Ziffer des Zeitzonenversatzes (z. B. 12 Stunden vor UTC) sein.

SELECT TO_TIMESTAMP('2019-02-28T23:59:59', 'YYYY-MM-DD"T"HH24:MI:SS');

Gültige Wertebereiche für Felder¶

Die empfohlenen Wertebereiche für jedes Feld sind nachstehend aufgeführt:

Verwenden der korrekten Anzahl von Ziffern mit Formatelementen¶

Für die meisten Felder (Jahr, Monat, Tag, Stunde, Minute und Sekunde) bestehen die Elemente (YYYY, MM, DD usw.) des Formatspezifizierers aus zwei oder vier Zeichen.

Die folgenden Regeln geben an, wie viele Stellen in den Literalwerten tatsächlich angegeben werden sollen.

• YYYY: Sie können für die Angabe des Jahres 1, 2, 3 oder 4 Ziffern verwenden. Snowflake empfiehlt jedoch die Angabe von 4 Ziffern. Stellen Sie gegebenenfalls führende Nullen voran. Beispiel: Das Jahr 536 AD würde beispielsweise „0536“ lauten.

• YY: Verwenden Sie für die Angabe des Jahres 1 oder 2 Ziffern. Snowflake empfiehlt jedoch die Angabe von 2 Ziffern. Stellen Sie gegebenenfalls eine führende Null voran.

• MM: Geben Sie eine oder zwei Ziffern an. Beispiel: Januar kann mit „01“ oder „1“ angegeben werden. Snowflake empfiehlt die Verwendung von zwei Ziffern.

• DD: Geben Sie eine oder zwei Ziffern an. Snowflake empfiehlt die Verwendung von zwei Ziffern.

• HH12 und HH24: Geben Sie eine oder zwei Ziffern an. Snowflake empfiehlt die Verwendung von zwei Ziffern.

• MI: Geben Sie eine oder zwei Ziffern an. Snowflake empfiehlt die Verwendung von zwei Ziffern.

• SS: Geben Sie eine oder zwei Ziffern an. Snowflake empfiehlt die Verwendung von zwei Ziffern.

• FF9: Geben Sie zwischen 1 und 9 Ziffern (einschließlich) an. Snowflake empfiehlt, die tatsächliche Anzahl signifikanter Stellen anzugeben. Nachstehende Nullen sind nicht erforderlich.

• TZH: Geben Sie eine oder zwei Ziffern an. Snowflake empfiehlt die Verwendung von zwei Ziffern.

• TZM: Geben Sie eine oder zwei Ziffern an. Snowflake empfiehlt die Verwendung von zwei Ziffern.

Für alle Felder (außer Sekundenbruchteilen) empfiehlt Snowflake die Angabe der maximalen Anzahl von Stellen. Verwenden Sie gegebenenfalls führende Nullen. Beispiel: „0001-02-03 04:05:06 -07:00“ folgt dem empfohlenen Format.

Nachstehende Nullen sind für Sekundenbruchteile optional. Im Allgemeinen wird empfohlen, nur die Anzahl der Stellen anzugeben, die zuverlässig und aussagekräftig sind. Wenn eine Zeitmessung beispielsweise auf 3 Dezimalstellen (Millisekunden) genau ist, kann die Angabe von 9 Ziffern (z. B. „0,123000000“) irreführend sein.

Leerzeichen in Werten und Formatangaben¶

Snowflake erzwingt das Anpassen von Leerzeichen in einigen, aber nicht allen Situationen. Die folgende Anweisung generiert beispielsweise einen Fehler, da im angegebenen Wert kein Leerzeichen zwischen den Tagen und den Stunden, im Formatbezeichner jedoch ein Leerzeichen zwischen DD und HH vorhanden ist:

SELECT TO_TIMESTAMP('2019-02-2823:59:59 -07:00', 'YYYY-MM-DD HH24:MI:SS TZH:TZM');

Die folgende Anweisung generiert jedoch keinen Fehler, obwohl der Wert ein Leerzeichen enthält, das im Bezeichner nicht angegeben ist:

SELECT TO_TIMESTAMP('2019-02-28 23:59:59.000000000 -07:00', 'YYYY-MM-DDHH24:MI:SS.FF TZH:TZM');

Der Grund für den Unterschied liegt darin, dass im ersten Fall die Werte nicht eindeutig wären, wenn nicht alle Felder ihre maximale Breite aufweisen würden. Beispielsweise könnte „213“ als 2 Tage und 13 Stunden oder als 21 Tage und 3 Stunden interpretiert werden. Das Format DDHH ist jedoch eindeutig mit DD HH identisch (bis auf das Leerzeichen).

Kontextabhängigkeit¶

Nicht alle Einschränkungen werden in allen Kontexten gleichermaßen durchgesetzt. Beispielsweise können einige Ausdrücke den 31. Februar als Übertrag interpretieren, andere möglicherweise nicht.

Zusammenfassung der Best Practices für die Angabe des Formats¶

Die folgenden bewährten Methoden minimieren Mehrdeutigkeiten und andere potenzielle Probleme in früheren, aktuellen und geplanten zukünftigen Versionen von Snowflake:

• Beachten Sie die Gefahren beim Mischen von Daten aus Quellen, die unterschiedliche Formate verwenden, z. B. beim Mischen von Daten, die dem allgemeinen US-Format MM-DD-YYYY und dem allgemeinen europäischen Format DD-MM-YYYY entsprechen.

• Geben Sie die maximale Anzahl von Stellen für jedes Feld an (außer Sekundenbruchteile). Verwenden Sie beispielsweise 4-stellige Jahresangaben, und geben Sie gegebenenfalls führende Nullen an.

• Geben Sie in einem Zeitstempel zwischen Datum und Uhrzeit ein Leerzeichen oder den Buchstaben T an.

• Leerzeichen (und das optionale T-Trennzeichen zwischen Datum und Uhrzeit) sollten in den Werten und im Formatbezeichner identisch sein.

• Verwenden Sie die Intervallarithmetik, wenn Sie einen Übertrag benötigen.

• Seien Sie vorsichtig, wenn Sie die AUTO-Formatierung verwenden. Geben Sie nach Möglichkeit das Format an, und stellen Sie sicher, dass die Werte immer dem angegebenen Format entsprechen.

• Formate sollten aus Sicherheitsgründen besser innerhalb eines Befehl als außerhalb angegeben werden, beispielsweise in einem Parameter wie DATE_INPUT_FORMAT (siehe Beispiel unten).

• Stellen Sie beim Verschieben von Skripten von einer Umgebung in eine andere sicher, dass datumsbezogene Parameter wie DATE_INPUT_FORMAT in der neuen Umgebung dieselben sind wie in der alten Umgebung (vorausgesetzt, die Werte haben auch dasselbe Format).