Skip to content

time_zone 时区支持

MatrixOne 使用的时区取决于三个系统变量:global.time_zonesession.time_zoneglobal.system_time_zone

  • global.system_time_zone 表示服务器系统时区。当服务器启动时,它会尝试确定主机的时区,并使用它来设置系统时区(system_time_zone)。

  • global.time_zone 表示服务器当前时区。初始 time_zone 值为 SYSTEM,表示服务器时区与系统时区相同。

你可以使用以下语句在运行时设置全局服务器时区,设置完成后无法在当前会话中生效,你需要先退出当前会话,再次重新连接 MatrixOne 时才会生效。

> SET GLOBAL time_zone = timezone;
  • 每个会话都有自己的会话时区,由当时的会话 time_zone 变量决定。最初,会话时区的变量值从全局 time_zone 变量中获得,但会话客户端可以更改自己的时区。但是这个这个设置只会在当前会话期间有效。
SET time_zone = timezone;

使用以下 SQL 语句查看当前全局时区、客户端时区和系统时区的值:

> SELECT @@global.time_zone, @@session.time_zone, @@global.system_time_zone;
+-------------+-------------+--------------------+
| @@time_zone | @@time_zone | @@system_time_zone |
+-------------+-------------+--------------------+
| timezone    | +08:00      | CST                |
+-------------+-------------+--------------------+
1 row in set (0.01 sec)

设置 time_zone 的值的格式:

  • SYSTEM 表示时区应与服务器系统时区相同。

  • UTC 表示时区设置为 UTC(Coordinated Universal Time,协调世界时)。仅支持“UTC”缩写作为时区使用。

  • 该值可以作为字符串给出,表示 UTC 时间的偏移,格式为“HH:MM”,带有 + 或 -,例如 +10:00 或者 -6:00。允许的范围是“-13:59”到“+14:00”。

当前会话时区设置会影响时区敏感时间值的显示和存储。即会影响执行 NOW() 等函数查询到的值以及存储在 TIMESTAMP 列中和从 TIMESTAMP 列中查询到的值。

会话时区设置不影响 UTC_TIMESTAMP() 等函数显示的值或 DATETIMEDATETIME 列中的值。

Note

只有 Timestamp 数据类型的值是受时区影响的。可以理解为,Timestamp 数据类型的实际表示使用的是(字面值 + 时区信息)。其它时间和日期类型,比如 Datetime/Date/Time 是不包含时区信息的,所以也不受到时区变化的影响。

> SELECT @@global.time_zone, @@session.time_zone, @@global.system_time_zone;
+-------------+-------------+--------------------+
| @@time_zone | @@time_zone | @@system_time_zone |
+-------------+-------------+--------------------+
| SYSTEM      | SYSTEM      | CST                |
+-------------+-------------+--------------------+
1 row in set (0.00 sec)

> create table t (ts timestamp, dt datetime);
Query OK, 0 rows affected (0.02 sec)

mysql> set @@time_zone = 'UTC';
Query OK, 0 rows affected (0.00 sec)

mysql> insert into t values ('2017-09-30 11:11:11', '2017-09-30 11:11:11');
Query OK, 1 row affected (0.02 sec)

mysql> set @@time_zone = '+08:00';
Query OK, 0 rows affected (0.00 sec)

mysql> select * from t;
+---------------------+---------------------+
| ts                  | dt                  |
+---------------------+---------------------+
| 2017-09-30 19:11:11 | 2017-09-30 11:11:11 |
+---------------------+---------------------+
1 row in set (0.00 sec)

上面的例子中,无论怎么调整时区的值,Datetime 类型字段的值是不受影响的,而 Timestamp 则随着时区改变,显示的值会发生变化。其实 Timestamp 持久化到存储的值始终没有变化过,只是根据时区的不同显示值不同。

Note

Timestamp 类型和 Datetime 等类型的值,两者相互转换的过程中,会涉及到时区。这种情况一律基于当前 time_zone 时区处理。

修改 MatrixOne 时区

  1. 查看当前时间或时区:
> select now();
+----------------------------+
| now()                      |
+----------------------------+
| 2022-10-14 18:38:27.876181 |
+----------------------------+
1 row in set (0.00 sec)

> show variables like "%time_zone%";
+------------------+--------+
| Variable_name    | Value  |
+------------------+--------+
| system_time_zone | CST    |
| time_zone        | SYSTEM |
+------------------+--------+
2 rows in set (0.00 sec)
  • time_zone:使用 system 的时区。

  • system_time_zone 说明 system 使用服务器系统时区。

  • 修改当前时区:

set global time_zone = '+08:00';
set time_zone = '+08:00';
  • set global time_zone = '+08:00';:修改 MatrixOne 全局时区为北京时间,即我们所在的东 8 区。
  • set time_zone = '+08:00';:修改当前会话时区。

限制

MatrixOne 仅支持 (+/-)HH:MM 格式和 UTC 来设置 time_zone 的值。