TO_DATE

📖 Описание

Функция Oracle/PLSQL TO_DATE преобразует строку в значение DATE.


🧩 Синтаксис

TO_DATE(string [, format_mask [, nlsparam]])

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

string — строка для преобразования; format_mask — её формат. Без маски используется NLS_DATE_FORMAT, поэтому в переносимых примерах формат лучше задавать явно.

nlsparam задаёт язык названий дат, например 'NLS_DATE_LANGUAGE = American'. Это строка параметра, а не просто имя языка.

Элемент Пояснение
YYYY Четырёхзначный год; предпочтителен для однозначного ввода.
YYY, YY, Y Сокращённый год; недостающие старшие разряды зависят от текущего года.
RR, RRRR RR определяет столетие двухзначного года по правилам текущего года; RRRR принимает также четыре цифры.
MM Номер месяца 01–12.
MON, MONTH Сокращённое или полное имя месяца; зависит от NLS_DATE_LANGUAGE.
RM Месяц римскими цифрами I–XII.
D Номер дня недели 1–7; зависит от NLS_TERRITORY.
DAY, DY Полное или сокращённое имя дня недели.
DD День месяца 1–31.
DDD День года 1–366.
J Целое число юлианского дня.
HH, HH12 Час 1–12; используется с AM/PM.
HH24 Час 0–23.
MI Минута 0–59.
SS Секунда 0–59.
SSSSS Количество секунд с полуночи 0–86399.
AM, A.M., PM, P.M. Период до или после полудня.
AD, A.D., BC, B.C. Обозначение эры.
FX Требует точного соответствия входной строки формату.

Ограничения форматов

IYYY/IYY/IY/I, IW, WW, W и Q описывают ISO-год, недели и квартал при выводе через TO_CHAR, но не являются элементами входной маски TO_DATE. FF и TZD/TZH/TZM/TZR не поддерживаются типом DATE: используйте TO_TIMESTAMP или TO_TIMESTAMP_TZ.

У RR правило столетия зависит от двух последних цифр текущего года: при 00–49 ввод 50–99 относится к предыдущему столетию; при 50–99 ввод 00–49 — к следующему; в остальных случаях используется текущее столетие. Для четырёхзначного ввода выбирайте YYYY.

Не передавайте уже готовый DATE в TO_DATE: это вызывает промежуточное преобразование в строку и создаёт зависимость от NLS.


💻 Примеры

При григорианском календаре первые три запроса дают одну дату. Во втором YY использует текущее столетие: показанный результат верен при выполнении в 2000–2099 годах.

SELECT TO_CHAR(TO_DATE('2026/06/17', 'YYYY/MM/DD'), 'YYYY-MM-DD')
FROM dual;
-- Результат: 2026-06-17

SELECT TO_CHAR(TO_DATE('061726', 'MMDDYY'), 'YYYY-MM-DD')
FROM dual;
-- Результат: 2026-06-17 при текущем столетии 2000–2099

SELECT TO_CHAR(TO_DATE('20260617', 'YYYYMMDD'), 'YYYY-MM-DD')
FROM dual;
-- Результат: 2026-06-17

SELECT TO_CHAR(
         TO_DATE('08.10.2026 16:25:40', 'DD.MM.YYYY HH24:MI:SS'),
         'YYYY-MM-DD HH24:MI:SS')
FROM dual;
-- Результат: 2026-10-08 16:25:40

TO_DATE возвращает дату, а внешний TO_CHAR — строку с явно заданным отображением.

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

См. документацию Oracle: модели формата.