后浪云OceanBase教程：OceanBase TIMESTAMP 数据类型

日期时间数据类型中除了 ​DATE​ 数据类型以外还有 ​TIMESTAMP[(scale)] ​时间戳数据类型。它是 ​DATE ​数据类型的扩展，跟 DATE 数据类型一样，它存储了年、月、日、时、分和秒等信息，但是不存储时区信息，它的时间最大可以精确到纳秒。所以它常用于存储时间精确度高和不需要考虑时区变换的数据。

语法

TIMESTAMP [(scale)]

参数

格式

​TIMESTAMP​ 数据类型的默认输入输出格式由 ​NLS_TIMESTAMP_FORMAT​ 决定，运行以下 SQL 语句查看默认格式：

SELECT @@NLS_TIMESTAMP_FORMAT FROM DUAL;

返回结果：

DD-MON-RR HH.MI.SSXFF AM

如果您需要自定义数据的格式，可以使用转换函数。在插入数据时，您可以通过函数 ​TO_TIMESTAMP (char,fmt) ​指定数据的输入格式。查询数据时，您可以通过函数 ​TO_CHAR (datetime,fmt) ​指定数据的输出格式。这两个转换函数会将字符串转化为参数 fmt 中定义的格式。在 ​fmt​ 未指明的情况下，使用默认格式。

取值范围

​0001-01-01 00:00:00.000000000​ ~ ​9999-12-31 23:59:59.999999999​

示例

• 示例1：如下代码所示，在表 Timestamp_Sample 中创建了数据类型为​TIMESTAMP​ 的两列 timestp1 和 timestp2， 并且为 timestp2 指定了时间的精度为 3。向两列同时使用​ TO_TIMESTAMP(string, format) ​插入日期值 2020-01-01 11:00:00。

CREATE TABLE Timestamp_Sample(timestp1 TIMESTAMP, timestp2 TIMESTAMP(3));
INSERT INTO Timestamp_Sample(timestp1,timestp2) VALUES(TO_TIMESTAMP('2020-01-01 11:00:00','YYYY-MM-DD HH24:MI:SS'),TO_TIMESTAMP('2020-01-01 11:00:00','YYYY-MM-DD HH24:MI:SS')); 
SELECT * FROM Timestamp_Sample;

结果如下，可以看到 timestp1 由于没有指定 scale 的值，所以结果时间精度默认为 6 位，timestp2 在指定后精度为 3 位：

+------------------------------+---------------------------+
| timestamp1                   | timestamp2                |
+------------------------------+---------------------------+
| 01-JAN-20 11.00.00.000000 AM | 01-JAN-20 11.00.00.000 AM |
+------------------------------+---------------------------+

• 示例2：以下语句使用函数​ TO_CHAR (datetime,fmt) ​指定输出格式。

SELECT TO_CHAR(TO_TIMESTAMP_TZ('25-FEB-20 11:00:00 AM America/Los_Angeles','DD-MON-RR HH:MI:SSXFF PM TZR'),'YYYY-MM-DD HH:MI:SSXFF PM TZR') Timestamp 
FROM DUAL;

返回结果：

+------------------------------------------------------+
| Timestamp                                            |
+------------------------------------------------------+
| 2020-02-25 11:00:00.000000000 AM America/Los_Angeles |
+------------------------------------------------------+