CONVERT_TZ

Синтаксис

CONVERT_TZ(dt,from_tz,to_tz)

Описание

CONVERT_TZ() преобразует значение datetime dt из часового пояса, заданного from_tz, в часовой пояс, заданный to_tz, и возвращает полученное значение.

Для использования именованных часовых поясов, таких как GMT, MET или Africa/Johannesburg, необходимо загрузить таблицы time_zone (см. mysql_tzinfo_to_sql).

Преобразование не выполнится, если значение выпадает за поддерживаемый диапазон TIMESTAMP ('1970-01-01 00:00:01' до '2038-01-19 05:14:07' UTC) при преобразовании из from_tz в UTC.

Функция возвращает NULL, если аргументы некорректны (или именованные часовые пояса не загружены).

См. часовые пояса для получения дополнительной информации.

Примеры

SELECT CONVERT_TZ('2016-01-01 12:00:00','+00:00','+10:00');
+-----------------------------------------------------+
| CONVERT_TZ('2016-01-01 12:00:00','+00:00','+10:00') |
+-----------------------------------------------------+
| 2016-01-01 22:00:00                                 |
+-----------------------------------------------------+

Использование именованных часовых поясов (при условии загрузки таблиц часовых поясов):

SELECT CONVERT_TZ('2016-01-01 12:00:00','GMT','Africa/Johannesburg');
+---------------------------------------------------------------+
| CONVERT_TZ('2016-01-01 12:00:00','GMT','Africa/Johannesburg') |
+---------------------------------------------------------------+
| 2016-01-01 14:00:00                                           |
+---------------------------------------------------------------+

Значение выходит за пределы диапазона TIMESTAMP, поэтому преобразование не выполняется:

SELECT CONVERT_TZ('1969-12-31 22:00:00','+00:00','+10:00');
+-----------------------------------------------------+
| CONVERT_TZ('1969-12-31 22:00:00','+00:00','+10:00') |
+-----------------------------------------------------+
| 1969-12-31 22:00:00                                 |
+-----------------------------------------------------+