TIMESTAMP

描述

TIMESTAMP 将符合日期时间格式的字符串转换为 DATETIME。输入为 TIMESTAMP_NS 时，返回 TIMESTAMP_NS 并保留纳秒精度。如果存在第二个时间参数，则将该时间值与第一个参数相加，并保留第一个参数对应的日期时间类型。

具体 datetime 格式请查看 datetime 的转换.

该函数与 mysql 中的 timestamp 函数 行为相同。

语法

TIMESTAMP(<date_or_datetime_string>[, <time_string>])

参数

参数	说明
date_or_datetime_string	日期或日期时间字符串，或 DATETIME、TIMESTAMP_NS 表达式。
time_string	时间字符串类型

返回值

输入为 TIMESTAMP_NS 时返回 TIMESTAMP_NS，并保持固定的 9 位小数秒精度。结果必须位于返回类型的取值范围内；TIMESTAMP_NS 的范围为 [1677-09-21 00:12:43.145224192, 2262-04-11 23:47:16.854775807]。

日期、日期时间和字符串输入返回 DATETIME；TIMESTAMP_NS 输入返回 TIMESTAMP_NS。

输入一个参数时，按照第一个参数对应的日期时间类型返回结果。 当输入参数数量为 2 时，返回两参数相加的结果

• 若第一个参数输入为 date 字符串,则时间被设置为 00:00:00
• 任一参数为 NULL或参数类型不匹配时，返回 NULL

举例

-- 将字符串转换为 DATETIME
SELECT TIMESTAMP('2019-01-01 12:00:00');

+------------------------------------+
| timestamp('2019-01-01 12:00:00')   |
+------------------------------------+
| 2019-01-01 12:00:00                |
+------------------------------------+

---输入 date 字符串
SELECT TIMESTAMP('2019-01-01');
+-------------------------+
| TIMESTAMP('2019-01-01') |
+-------------------------+
| 2019-01-01 00:00:00     |
+-------------------------+

--输入 NULL,返回 NULL
SELECT TIMESTAMP(NULL);
+-----------------+
| TIMESTAMP(NULL) |
+-----------------+
| NULL            |
+-----------------+

-- 两个参数，返回两个参数相加的结果(Date/DateTime + Time)
SELECT TIMESTAMP('2025-11-30 23:45:12', '12:34:56'); 
+----------------------------------------------+
| TIMESTAMP('2025-11-30 23:45:12', '12:34:56') |
+----------------------------------------------+
| 2025-12-01 12:20:08                          |
+----------------------------------------------+

-- 第一个参数仅接受Date/Datetime类型，第二个参数仅接受 Time 类型
SELECT TIMESTAMP('12:34:56', '12:34:56');
+-----------------------------------+
| TIMESTAMP('12:34:56', '12:34:56') |
+-----------------------------------+
| NULL                              |
+-----------------------------------+

-- 任一参数为 NULL， 返回 NULL
SELECT TIMESTAMP('2025-12-01', NULL);
+-------------------------------+
| TIMESTAMP('2025-12-01', NULL) |
+-------------------------------+
| NULL                          |
+-------------------------------+