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 — строку с явно заданным отображением.