TO_TIMESTAMP_TZ

📖 Описание

Функция Oracle/PLSQL TO_TIMESTAMP_TZ преобразует строку в значение TIMESTAMP WITH TIME ZONE с часовым поясом.


🧩 Синтаксис

TO_TIMESTAMP_TZ(string1 [, format_mask [, nlsparam]])

⚙️ Параметры и аргументы

string1 — преобразуемая строка. format_mask — её формат; без маски используется NLS_TIMESTAMP_TZ_FORMAT сеанса.

nlsparam позволяет указать NLS_DATE_LANGUAGE для названий месяцев. Возвращается TIMESTAMP WITH TIME ZONE, а не TIMESTAMP WITH LOCAL TIME ZONE.

Элемент Назначение
YYYY Год из четырёх цифр
MM Номер месяца 01–12
MON Сокращённое название месяца на языке NLS_DATE_LANGUAGE
MONTH Полное название месяца; при выводе обычно дополняется пробелами до максимальной длины названия для выбранного языка
DD День месяца 01–31
HH / HH12 Часы 01–12; для различения половин суток используют AM/PM
HH24 Часы 00–23
MI Минуты 00–59
SS Секунды 00–59
FF1 … FF9 Дробная часть секунды
TZH Часы смещения часового пояса
TZM Минуты смещения часового пояса

💻 Примеры

В примерах используется григорианский календарь; TO_CHAR задаёт формат результата независимо от формата вывода TIMESTAMP в клиенте:

SELECT TO_CHAR(
         TO_TIMESTAMP_TZ('2026/06/07 16:45:20.125 +05:00',
           'YYYY/MM/DD HH24:MI:SS.FF3 TZH:TZM'),
         'YYYY-MM-DD HH24:MI:SS.FF3 TZH:TZM'
       ) AS converted_time
FROM dual;
-- Результат: 2026-06-07 16:45:20.125 +05:00

Для текстового месяца явно зададим язык AMERICAN:

SELECT TO_CHAR(
         TO_TIMESTAMP_TZ('2026/JUN/07 16:45:20 +05:00',
           'YYYY/MON/DD HH24:MI:SS TZH:TZM',
           'NLS_DATE_LANGUAGE=AMERICAN'),
         'YYYY-MM-DD HH24:MI:SS.FF3 TZH:TZM'
       ) AS converted_time
FROM dual;
-- Результат: 2026-06-07 16:45:20.000 +05:00

См. документацию Oracle 19: TO_TIMESTAMP_TZ.

См. документацию Oracle 19: Format-Models.