- Catégories :
Fonctions contextuelles (Général)
LOCALTIME¶
Renvoie l’heure actuelle du système.
Alias conforme à ANSI pour CURRENT_TIME .
Syntaxe¶
LOCALTIME()
LOCALTIME
Arguments¶
Aucun.
Renvoie¶
Renvoie une valeur de type TIME.
Notes sur l’utilisation¶
La configuration du paramètre TIMEZONE affecte la valeur de retour. L’heure renvoyée est indiquée dans le fuseau horaire de la session.
Le format d’affichage des heures dans la sortie est déterminé par le paramètre de session TIME_OUTPUT_FORMAT (par défaut,
HH24:MI:SS
).Pour respecter la norme ANSI, cette fonction peut être appelée sans parenthèses dans les instructions SQL.
Cependant, si vous définissez une variable Snowflake Scripting sur une expression qui appelle la fonction (par exemple,
my_var := <function_name>();
), vous devez inclure les parenthèses. Pour plus d’informations, voir les notes sur l’utilisation des fonctions de contexte.N’utilisez pas la valeur renvoyée pour un ordre chronologique précis entre les requêtes simultanées (traitées par le même entrepôt virtuel), car les requêtes peuvent être traitées par des ressources de calcul différentes (dans l’entrepôt).
Exemples¶
Affiche l’heure locale actuelle et l’horodatage local :
SELECT LOCALTIME(), LOCALTIMESTAMP();
+-------------+-------------------------------+
| LOCALTIME() | LOCALTIMESTAMP() |
|-------------+-------------------------------|
| 15:32:45 | 2024-04-17 15:32:45.775 -0700 |
+-------------+-------------------------------+