TO_CHAR
📖 Описание
Функция Oracle/PLSQL TO_CHAR преобразует число, дату, временную метку или интервал в строку VARCHAR2.
🧩 Синтаксис
TO_CHAR(value [, format_mask [, nlsparam]])
⚙️ Параметры и аргументы
value — преобразуемое значение; format_mask — необязательная маска формата. Для дат nlsparam задаёт NLS_DATE_LANGUAGE, а для чисел — числовые разделители и параметры валюты; это не один общий параметр языка.
Без явных параметров результат может зависеть от настроек сеанса. В примерах ниже даты фиксированы, используется григорианский календарь, язык названий и числовые разделители заданы явно.
💻 Примеры для чисел
SELECT TO_CHAR(2356.84, 'FM9999D9', 'NLS_NUMERIC_CHARACTERS=''.,''') FROM dual;
-- Результат: 2356.8
SELECT TO_CHAR(-2356.84, 'FM9999D9', 'NLS_NUMERIC_CHARACTERS=''.,''') FROM dual;
-- Результат: -2356.8
SELECT TO_CHAR(2356.84, 'FM9G999D00', 'NLS_NUMERIC_CHARACTERS=''.,''') FROM dual;
-- Результат: 2,356.84
SELECT TO_CHAR(2356.84, 'FM$9G999D00', 'NLS_NUMERIC_CHARACTERS=''.,''') FROM dual;
-- Результат: $2,356.84
SELECT TO_CHAR(42, 'FM000000') FROM dual;
-- Результат: 000042
Форматы дат
Элементы маски можно сочетать; они определяют представление, а не изменяют хранимое значение даты.
| Параметр | Пояснение |
|---|---|
| YEAR | Год прописью на английском языке. |
| YYYY | 4-значный год. |
| YYY YY Y |
Последние 3, 2 или 1 цифра(ы) года. |
| IYY IY I |
Последние 3, 2 или 1 цифра(ы) года ISO. |
| IYYY | 4-значный год в соответствии со стандартом ISO. |
| Q | Квартал года (1, 2, 3, 4; JAN-MAR = 1). |
| MM | Месяц (01-12; JAN = 01). |
| MON | Сокращенное название месяца. |
| MONTH | Название месяца; дополнение пробелами зависит от самого длинного названия в выбранном языке и календаре. |
| RM | Римская цифра RM (I-XII; JAN = I). |
| WW | Неделя года (1-53), где неделя 1 начинается в первый день года и продолжается до седьмого дня года. |
| W | Неделя месяца (1-5), где неделя 1 начинается в первый день месяца и заканчивается седьмым. |
| IW | Неделя года (1-52 или 1-53) на основе стандарта ISO. |
| D | День недели (1-7); первый день определяется NLS_TERRITORY. |
| DAY | Название дня. |
| DD | День месяца (1-31). |
| DDD | День года (1-366). |
| DY | Сокращенное название дня. |
| J | юлианский день; количество дней с 1 января 4712 г. до н.э. |
| HH | Час дня (1-12). |
| HH12 | Час дня (1-12). |
| HH24 | Час дня (0-23). |
| MI | Минуты (0-59). |
| SS | Секунды (0-59). |
| SSSSS | Секунды после полуночи (0-86399). |
| FF | Дробные секунды для TIMESTAMP и интервалов, но не DATE. |
SELECT TO_CHAR(DATE '2026-06-09', 'YYYY/MM/DD') FROM dual;
-- Результат: 2026/06/09
SELECT TO_CHAR(DATE '2026-06-09', 'YYYY.MM.DD') FROM dual;
-- Результат: 2026.06.09
SELECT '[' || TO_CHAR(DATE '2026-06-09', 'Month DD, YYYY', 'NLS_DATE_LANGUAGE=English') || ']' FROM dual;
-- Результат: [June 09, 2026]
SELECT TO_CHAR(DATE '2026-06-09', 'FMMonth DD, YYYY', 'NLS_DATE_LANGUAGE=English') FROM dual;
-- Результат: June 9, 2026
SELECT TO_CHAR(DATE '2026-06-09', 'MON DDth, YYYY', 'NLS_DATE_LANGUAGE=English') FROM dual;
-- Результат: JUN 09TH, 2026
SELECT TO_CHAR(DATE '2026-06-09', 'FMMON DDth, YYYY', 'NLS_DATE_LANGUAGE=English') FROM dual;
-- Результат: JUN 9TH, 2026
SELECT TO_CHAR(DATE '2026-06-09', 'FMMon ddth, YYYY', 'NLS_DATE_LANGUAGE=English') FROM dual;
-- Результат: Jun 9th, 2026
FM убирает дополнение пробелами и ведущими нулями у элементов даты: день 09 становится 9. В числовой маске обязательные позиции 0 сохраняются, поэтому FM000000 возвращает 000042.
❓ Как отсортировать дни недели?
Сортировка по TO_CHAR(date_value, 'FMDay') упорядочивает названия, а не дни. Маска D возвращает номер дня, но начало недели зависит от NLS_TERRITORY; для порядка с понедельника используйте разность с началом ISO-недели:
WITH workshop_dates (workshop_id, event_date) AS (
SELECT 1, DATE '2026-06-14' FROM dual UNION ALL
SELECT 2, DATE '2026-06-08' FROM dual UNION ALL
SELECT 3, DATE '2026-06-09' FROM dual
)
SELECT workshop_id,
TO_CHAR(event_date, 'YYYY-MM-DD') AS event_date,
TO_CHAR(event_date, 'FMDay', 'NLS_DATE_LANGUAGE=English') AS weekday
FROM workshop_dates
ORDER BY TRUNC(event_date) - TRUNC(event_date, 'IW'), event_date, workshop_id;
| WORKSHOP_ID | EVENT_DATE | WEEKDAY |
|---|---|---|
| 2 | 2026-06-08 | Monday |
| 3 | 2026-06-09 | Tuesday |
| 1 | 2026-06-14 | Sunday |
См. документацию Oracle: TO_CHAR для чисел.