Kategorien:

Kontextfunktionen (Allgemein)

LOCALTIME

Gibt die aktuelle Uhrzeit des Systems zurück.

ANSI-kompatibler Alias für CURRENT_TIME.

Syntax

LOCALTIME()

LOCALTIME
Copy

Argumente

Keine.

Rückgabewerte

Gibt einen Wert vom Typ TIME zurück.

Nutzungshinweise

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

  • Das Anzeigeformat für Zeitwerte in der Ausgabe wird durch den Sitzungsparameter TIME_OUTPUT_FORMAT bestimmt (Standard: HH24:MI:SS).

  • 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 := <function_name>();), müssen Sie die Klammern einschließen. Weitere Informationen finden Sie unter in den Nutzungshinweisen für Kontextfunktionen.

  • 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.

Beispiele

Anzeigen der aktuellen Ortszeit sowie des lokalen Zeitstempels:

SELECT LOCALTIME(), LOCALTIMESTAMP();
Copy
+-------------+-------------------------------+
| LOCALTIME() | LOCALTIMESTAMP()              |
|-------------+-------------------------------|
| 15:32:45    | 2024-04-17 15:32:45.775 -0700 |
+-------------+-------------------------------+