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