类别：

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

LOCALTIMESTAMP

返回采用本地时区的系统当前时间戳。

与 ANSI 兼容的 CURRENT_TIMESTAMP 别名。

语法

LOCALTIMESTAMP( [ <fract_sec_precision> ] )

LOCALTIMESTAMP
Copy

实参

fract_sec_precision

此可选实参表示报告时间的精度。例如，值为 3 表示在小数点后使用 3 位数（即指定时间精度为毫秒）。

默认精度为 9（纳秒）。

有效值介于 0-9 之间。但是，大多数平台不支持真正的纳秒精度；您获得的精度可能低于您指定的精度。实际上，精度通常最多约为毫秒（3 位数）。

备注

仅当会话的 TIMESTAMP_OUTPUT_FORMAT 参数中明确设置了小数秒（例如 'YYYY-MM-DD HH24:MI:SS.FF'），才会显示小数秒。

返回

返回当前系统时间。返回值的数据类型是 TIMESTAMP_LTZ。

使用说明

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

  • TIMESTAMP_TYPE_MAPPING 参数的设置 不 会影响返回值。

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

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

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

示例

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

SELECT LOCALTIME(), LOCALTIMESTAMP();
Copy
+-------------+-------------------------------+
| LOCALTIME() | LOCALTIMESTAMP()              |
|-------------+-------------------------------|
| 07:58:09    | 2024-04-18 07:58:09.848 -0700 |
+-------------+-------------------------------+
语言: 中文