类别：

:doc:`/sql-reference/functions-context`（通用）

LOCALTIME

返回系统的当前时间。

与 ANSI 兼容的 CURRENT_TIME 别名。

语法

LOCALTIME()

LOCALTIME
Copy

实参

无。

返回

返回类型 TIME 的值。

使用说明

  • TIMEZONE 参数的设置会影响返回值。返回的时间位于会话的时区内。

  • 输出中的时间显示格式由 TIME_OUTPUT_FORMAT 会话参数（默认为 HH24:MI:SS）确定。

  • 为符合 ANSI 标准，可以在 SQL 语句中调用此函数，而不必带括号。

    然而，如果要将 Snowflake Scripting 变量 设置为调用这些函数的表达式（例如，my_var := <function_name>();），则必须包含圆括号。有关更多信息，请参阅 上下文函数的用法说明。

  • 请勿将返回值用于（由同一虚拟仓库处理的）并发查询之间的精确时间排序，因为查询可能由（仓库中）不同计算资源提供服务。

示例

显示当前本地时间和本地时间戳：

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