跳到主要内容
版本：Latest-3.3

convert_tz

功能​

将给定的时间转化为另一个时区的时间。

该函数受时区影响，具体参见 设置时区。

语法​

DATETIME CONVERT_TZ(DATE|DATETIME dt, VARCHAR from_tz, VARCHAR to_tz)

参数说明​

  • dt：需要转化的时间。支持的数据类型为 DATE 和 DATETIME。
  • from_tz：源时区名称。支持的数据类型为 VARCHAR。 时区可以使用两种格式：时区信息数据库（Time Zone Database，比如 Asia/Shanghai），或 UTC 偏移量（例如+08: 00）。
  • to_tz：目标时区名称。支持的数据类型为 VARCHAR。格式同参数 from_tz。

返回值说明​

返回值的数据类型为 DATETIME。如果输入值为 DATE，默认基于 00:00:00进行转换。如果输入值类型不合法，返回NULL。

注意事项​

各时区对应的时区信息数据库，请参见时区数据库（来源：维基百科）。

示例​

示例一：将上海时间转化为洛杉矶时间。


select convert_tz('2019-08-01 13:21:03', 'Asia/Shanghai', 'America/Los_Angeles');
+---------------------------------------------------------------------------+
| convert_tz('2019-08-01 13:21:03', 'Asia/Shanghai', 'America/Los_Angeles') |
+---------------------------------------------------------------------------+
| 2019-07-31 22:21:03                                                       |
+---------------------------------------------------------------------------+
1 row in set (0.00 sec)

示例二：将东八区时间转化为洛杉矶时间。

select convert_tz('2019-08-01 13:21:03', '+08:00', 'America/Los_Angeles');
+--------------------------------------------------------------------+
| convert_tz('2019-08-01 13:21:03', '+08:00', 'America/Los_Angeles') |
+--------------------------------------------------------------------+
| 2019-07-31 22:21:03                                                |
+--------------------------------------------------------------------+
1 row in set (0.00 sec)

示例三：将 DATE 类型的日期 2019-08-01 进行转化。

select convert_tz('2019-08-01', 'Asia/Shanghai', 'America/Los_Angeles');
+------------------------------------------------------------------+
| convert_tz('2019-08-01', 'Asia/Shanghai', 'America/Los_Angeles') |
+------------------------------------------------------------------+
| 2019-07-31 09:00:00                                              |
+------------------------------------------------------------------+
1 row in set (0.00 sec)