跳到主要内容

LOCALTIME,LOCALTIMESTAMP

描述

函数用于获取当前系统时间,返回值为日期时间类型(DATETIME)。可以选择性地指定精度以调整返回值的小数秒部分的位数。

语法

LOCALTIME([<precision>])
LOCALTIMESTAMP([<precision>]))

参数

参数说明
<precision>可选参数,表示返回值的小数秒部分的精度,取值范围为 0 到 6。默认为 0,即不返回小数秒部分。
受限于JDK实现,如果用户使用JDK8构建FE,则精度最多支持到毫秒(小数点后三位),更大的精度位将全部填充0。如果用户有更高精度需求,请使用JDK11。

返回值

  • 返回当前系统时间,类型为 DATETIME
  • 如果指定的 <precision> 超出范围(如为负数或大于 6),函数会返回错误。

举例

select LOCALTIME(),LOCALTIME(3),LOCALTIME(6);
+---------------------+-------------------------+----------------------------+
| now() | now(3) | now(6) |
+---------------------+-------------------------+----------------------------+
| 2025-01-23 11:50:18 | 2025-01-23 11:50:18.883 | 2025-01-23 11:50:18.883000 |
+---------------------+-------------------------+----------------------------+