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 для чисел.

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

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