Kategorien:

Kontextfunktionen (Allgemein)

CURRENT_TIMESTAMP

Gibt den aktuellen Zeitstempel in der lokalen Zeitzone zurück.

Aliasse:

LOCALTIMESTAMP , GETDATE , SYSTIMESTAMP

Syntax

CURRENT_TIMESTAMP( [ <fract_sec_precision> ] )

CURRENT_TIMESTAMP
Copy

Argumente

fract_sec_precision

Dieses optionale Argument gibt die Genauigkeit an, mit der die Uhrzeit gemeldet werden soll. Bei einem Wert von 3 werden beispielsweise 3 Nachkommastellen verwendet (d. h. die Zeit wird mit einer Genauigkeit von Millisekunden angegeben).

Die Standardgenauigkeit ist 9 (Nanosekunden).

Gültige Werte liegen zwischen 0 und 9. Die meisten Plattformen unterstützen jedoch keine echte Nanosekundengenauigkeit. Die Genauigkeit, die Sie erhalten, ist möglicherweise geringer als die von Ihnen angegebene Genauigkeit. In der Praxis liegt die Genauigkeit meist höchstens im Millisekundenbereich (3 Stellen).

Bemerkung

Sekundenbruchteile werden nur angezeigt, wenn sie explizit im Parameter TIMESTAMP_OUTPUT_FORMAT für die Sitzung festgelegt worden sind (z. B. 'YYYY-MM-DD HH24:MI:SS.FF').

Rückgabewerte

Gibt die aktuelle Systemzeit zurück. Der Datentyp des zurückgegebenen Werts ist TIMESTAMP_LTZ.

Nutzungshinweise

  • Die Einstellung des Parameters TIMEZONE wirkt sich auf den Rückgabewert aus. Der zurückgegebene Zeitstempel wird in der Zeitzone der Sitzung angegeben.

  • Die Einstellung des Parameters TIMESTAMP_TYPE_MAPPING wirkt sich nicht auf den Rückgabewert aus.

  • Verwenden Sie den zurückgegebenen Wert nicht für eine genaue zeitliche Reihenfolge zwischen gleichzeitigen Abfragen (die vom selben virtuellen Warehouse verarbeitet werden), da die Abfragen möglicherweise von verschiedenen Computeressourcen (im Warehouse) verarbeitet werden.

  • Zur Erfüllung der ANSI-Standards kann diese Funktion in SQL-Anweisungen ohne Klammern aufgerufen werden.

    Wenn Sie jedoch eine Snowflake Scripting-Variable für einen Ausdruck festlegen, der die Funktion aufruft (z. B. my_var := CURRENT_TIMESTAMP();), müssen Sie die Klammern einschließen. Weitere Informationen finden Sie unter in den Nutzungshinweisen für Kontextfunktionen.

  • Die Aliasse SYSTIMESTAMP und GETDATE unterscheiden sich von CURRENT_TIMESTAMP in folgenden Punkten:

    • Sie unterstützen nicht den Parameter fract_sec_precision.

    • Diese Funktionen müssen mit Klammern aufgerufen werden.

Beispiele

Stellen Sie das Zeitausgabeformat auf YYYY-MM-DD HH24:MI:SS.FF ein:

ALTER SESSION SET TIMESTAMP_OUTPUT_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF';
Copy

Geben Sie den aktuellen Zeitstempel mit einer Genauigkeit der Sekundenbruchteile von 2 zurück:

SELECT CURRENT_TIMESTAMP(2);
Copy
+------------------------+
| CURRENT_TIMESTAMP(2)   |
|------------------------|
| 2024-04-17 15:41:38.29 |
+------------------------+

Geben Sie den aktuellen Zeitstempel mit einer Genauigkeit der Sekundenbruchteile von 4 zurück:

SELECT CURRENT_TIMESTAMP(4);
Copy
+--------------------------+
| CURRENT_TIMESTAMP(4)     |
|--------------------------|
| 2024-04-17 15:42:14.2100 |
+--------------------------+

Geben Sie den aktuellen Zeitstempel mit der Standard-Genauigkeit der Sekundenbruchteile (9) zurück:

SELECT CURRENT_TIMESTAMP;
Copy
+-------------------------------+
| CURRENT_TIMESTAMP             |
|-------------------------------|
| 2024-04-17 15:42:55.130000000 |
+-------------------------------+
Sprache: Deutsch