GBase 8a MPP Cluster 支持的日期和时间类型介绍

GBase 8a MPP Cluster 支持的日期和时间类型，如下表所示：

类型名称	最小值	最大值	格式
DATE	0001-01-01	########	YYYY-MM-dd
DATETIME	0001-01-01 00:00:00.000000	9999-12-31 23:59:59.999999	YYYY-MM-dd HH:MI:SS.ffffff
TIME	-838:59:59	########	HHH:MI:SS
TIMESTAMP	1970-01-01 08:00:01	2038-01-01 00:59:59	YYYY-MM-DD HH:MI:SS

       当使用日期和时间类型时， 输入的数据应符合要求的格式：如，YYYY-MM-DD、 YYYY-MM-DD HH:MI:SS。
 

DATE
 

       日期类型。支持的范围是‚0001-01-01‛到‚9999-12-31‛。
       GBase 8a MPP Cluster 以‚YYYY-MM-DD‛格式显示 DATE 值。
       示例 1：插入一个标准的 DATE 值。
gbase> CREATE TABLE products (productDate DATE);
Query OK, 0 rows affected
gbase> INSERT INTO products(productDate) VALUES('2010-09-01');
Query OK, 1 row affected
gbase> SELECT productDate FROM products;
+-------------+
| productDate |
+-------------+
| 2010-09-01 |
+-------------+
1 row in set
示例 2：插入一个 NULL 值。
gbase> CREATE TABLE products (productDate DATE);
Query OK, 0 rows affected
gbase> INSERT INTO products(productDate) VALUES(NULL);
Query OK, 1 row affected
gbase> SELECT productDate FROM products;
+-------------+
| productDate |
+-------------+
| NULL |
+-------------+
1 rows in set
示例 3：插入一个非法的 DATE 值，系统报告错误信息。
gbase> CREATE TABLE products (productDate DATE);
Query OK, 0 rows affected
gbase> INSERT INTO products(productDate) VALUES('2010-09-31');
ERROR 1292 (22007): Incorrect date value: '2010-09-31' for column 'productDate' at row 1

TIME
 

       GBase 8a MPP Cluster 以‚HH:MI:SS‛格式（或‚HHH:MI:SS‛格式）检索和显示 TIME 值，该值为字符串。
       TIME 的范围是‚-838:59:59‛到‚838:59:59‛。 TIME 类型不仅可以用于表示一天的时间，而且可以用来表示所经过的时间或两个事件之间的时间
间隔（这可能比 24 小时大许多或是一个负值）。
       对于以字符串指定的包含时间界定符的 TIME 值，小于 10 的时、分或秒，
可以不指定为两位数值。‚8:3:2‛与‚08:03:02‛是一致的。
       TIME 值可以多种格式指定：
       一个'D HH:MM:SS.fraction'格式的字符串。下面所示的任一种‚宽松‛
的语法均可以被使用： 'HH:MM:SS.fraction'， 'HH:MM:SS'， 'HHl:MM'， 'D
HH:MM:SS'， 'D HH:MM'， 'D HH'，或'SS'。这里的 D 是一个在 0-34 之间的天数。
       注意， fraction 部分可以精确到微秒。
示例 1：插入一个合法的 TIME 值。
gbase> CREATE TABLE products (productDate TIME);
Query OK, 0 rows affected
gbase> INSERT INTO products(productDate) VALUES('12:09:44');
Query OK, 1 row affected
gbase> SELECT productDate FROM products;
+-------------+
| productDate |
+-------------+
| 12:09:44 |
+-------------+
1 row in set
示例 2：插入一个在‚-838:59:59‛到‚838:59:59‛之间，且超过 24小时之间的 TIME 值。
gbase> CREATE TABLE products (productDate TIME);
Query OK, 0 rows affected
gbase> INSERT INTO products(productDate) VALUES('92:09:44');
Query OK, 1 row affected
gbase> SELECT productDate FROM products;
+-------------+
| productDate |
+-------------+
| 92:09:44 |
+-------------+
1 row in set
 

DATETIME
 

       GBase 8a MPP Cluster 以‚YYYY-MM-DD HH:MI:SS.ffffff‛格式显示DATETIME 值。其中 ffffff 表示微秒格式。
       日期和时间的组合类型。支持的范围是‚0001-01-01 00:00:00.000000‛到‚9999-12-31 23:59:59.999999‛。
       示例 1：插入一个合法的 DATETIME 值。
gbase> CREATE TABLE products (productDate DATETIME);
Query OK, 0 rows affected
gbase> INSERT INTO products(productDate) VALUES('2010-09-01 12:09:44');
Query OK, 1 row affected
gbase> SELECT productDate FROM products;
+---------------------+
| productDate |
+---------------------+
| 2010-09-01 12:09:44 |
+---------------------+
1 row in set
示例 2：插入系统当前的 DATATIME 值。
gbase> INSERT INTO products(productDate) VALUES(NOW());
Query OK, 1 row affected
gbase> SELECT productDate FROM products;
+---------------------+
| productDate |
+---------------------+
| 2013-10-16 17:51:38 |
+---------------------+
1 row in set
示例 3：插入一个 NULL 值。
gbase> INSERT INTO products(productDate) VALUES(NULL);
Query OK, 1 row affected
gbase> SELECT productDate FROM products;
+-------------+
| productDate |
+-------------+
| NULL |
+-------------+
1 row in set
示例 4： 插入一个带有微秒的 DATETIME 数值。
gbase> INSERT INTO products(productDate) VALUES('2013-09-15
12:09:44.123456');
Query OK, 1 row affected
gbase> SELECT productDate FROM products;
+----------------------------+
| productDate |
+----------------------------+
| 2013-09-15 12:09:44.123456 |
+----------------------------+
1 row in set
示例 5：插入一个非法的 DATETIME 值，系统将报告错误信息。
gbase> INSERT INTO products(productDate) VALUES('2010-09-31 12:09:44');
ERROR 1292 (22007): Incorrect datetime value: '2010-09-31 12:09:44' for column
'productDate' at row 1
 

TIMESTAMP
 

        TIMESTAMP 类型仅仅是为了兼容 SQL 标准，因此，不建议使用者在实际的项目应用场景使用此数据类型，推荐使用 DATETIME 数据类型。
       TIMESTAMP 的格式为‚YYYY-MM-DD HH:MI:SS‛，支持的范围是‚1970-01-01 08:00:01‛到‚2038-01-01 00:59:59‛。
例如：
gbase> CREATE TABLE t (a int,b timestamp DEFAULT CURRENT_TIMESTAMP ON UPDATE
CURRENT_TIMESTAMP, c timestamp DEFAULT '2013-01-01 00:00:01');
Query OK, 0 rows affected
gbase> SHOW CREATE TABLE t;
+-------+----------------------------------------------------------------+
| Table | Create Table |
+-------+----------------------------------------------------------------+
| t | CREATE TABLE "t" (
"a" int(11) DEFAULT NULL,
"b" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
"c" timestamp NOT NULL DEFAULT '2013-01-01 00:00:01'
) ENGINE=EXPRESS DEFAULT CHARSET=utf8 TABLESPACE='sys_tablespace' |
+-------+----------------------------------------------------------------+
1 row in set

TIMESTAMP 使用限制：
       以下限制说明，是针对 TIMESTAMP 数据列自动更新时的场景：
       使用 DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP 属性
后， TIMESTAMP 列在支持 INSERT、 UPDATE 以及 MERGE 时，它的值自动更新。需要注意的是 DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP在一张表中只能给第一个 TIMESTAMP 列使用一次，也就是含有多个 TIMESTAMP列时，只能给第一次出现TIMESTAMP 列使用 DEFAULT CURRENT_TIMESTAMP ONUPDATE CURRENT_TIMESTAMP 属性。
        创建一张表时，如果只定义一个 TIMESTAMP 列，则 DEFAULTCURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP 可以省略，系统会自动添加上。