ORA-01861: 리터럴이 형식 문자열과 일치하지 않음
ORA-01861: 리터럴이 형식 문자열과 일치하지 않음ORA-01861: literal does not match format string날짜 문자열에 형식에 없는 글자가 들어 있어요.
실제 DB 검증Oracle AI Database 26ai Free 23.26.3.0.0에서 재현·해결 확인 · 2026-11-12
ORA-01861은 문자열을 날짜로 바꿀 때 문자열의 글자 배치가 형식과 안 맞으면 나요. 형식은 TO_DATE에 직접 준 것, 안 줬다면 세션의 NLS_DATE_FORMAT이에요.
에러는 문자열 위치에 *만 찍어 주고 형식은 안 보여 줘요. 두 개를 나란히 놓고 보세요. 문자열에 있는 날짜 아닌 글자(T, 년 등)는 형식에도 있어야 해요.
원인별 해결 방법
1DATE 컬럼을 그냥 문자열과 비교
WHERE order_date >= '2026-11-01'은 DATE와 문자열을 비교하니, 오라클이 문자열을 세션의 NLS_DATE_FORMAT으로 바꿔요. 여기서는 DD-MON-RR이라 2026-11-01과 맞지 않아요.
날짜 리터럴 DATE '2026-11-01'이나 TO_DATE('2026-11-01', 'YYYY-MM-DD')로 쓰면, 세션은 그대로 DD-MON-RR인데도 2·3번 주문이 조회됐어요.
사전 준비
CREATE TABLE orders (order_id NUMBER PRIMARY KEY, order_date DATE);
INSERT INTO orders VALUES (1, DATE '2026-10-30');
INSERT INTO orders VALUES (2, DATE '2026-11-05');
INSERT INTO orders VALUES (3, DATE '2026-11-12');
COMMIT;Table created.
1 row created.
1 row created.
1 row created.
Commit complete.ALTER SESSION SET NLS_DATE_FORMAT = 'DD-MON-RR';
SELECT order_id FROM orders WHERE order_date >= '2026-11-01';Session altered.
SELECT order_id FROM orders WHERE order_date >= '2026-11-01'
*
ERROR at line 1:
ORA-01861: literal does not match format string
Help: https://docs.oracle.com/error-help/db/ora-01861/ALTER SESSION SET NLS_DATE_FORMAT = 'DD-MON-RR';
SELECT value FROM nls_session_parameters WHERE parameter = 'NLS_DATE_FORMAT';Session altered.
VALUE
----------------------------------------------------------------
DD-MON-RR
1 row selected.세션마다 NLS_DATE_FORMAT이 달라서, 이런 쿼리는 어떤 도구에서는 되고 프로그램에서는 안 되기도 해요. DATE 컬럼은 문자열과 바로 비교하지 마세요.
ALTER SESSION SET NLS_DATE_FORMAT = 'DD-MON-RR';
SELECT order_id FROM orders WHERE order_date >= DATE '2026-11-01' ORDER BY order_id;
SELECT order_id FROM orders WHERE order_date >= TO_DATE('2026-11-01', 'YYYY-MM-DD') ORDER BY order_id;Session altered.
ORDER_ID
----------
2
3
2 rows selected.
ORDER_ID
----------
2
3
2 rows selected.2날짜와 시간 사이에 T가 있는 ISO 8601 문자열
API·JSON에서 받은 날짜는 2026-11-12T14:30:00처럼 오는 경우가 많아요. 형식 YYYY-MM-DD HH24:MI:SS는 그 자리가 공백이라 T와 안 맞아요.
형식에 T를 큰따옴표로 넣으세요: YYYY-MM-DD"T"HH24:MI:SS. VALIDATE_CONVERSION으로 보면 공백 형식은 0, 따옴표 형식은 1이었고, 2026-11-12 14:30:00으로 들어갔어요.
사전 준비
CREATE TABLE api_logs (log_id NUMBER PRIMARY KEY, created_at DATE);Table created.INSERT INTO api_logs VALUES (1, TO_DATE('2026-11-12T14:30:00', 'YYYY-MM-DD HH24:MI:SS'));INSERT INTO api_logs VALUES (1, TO_DATE('2026-11-12T14:30:00', 'YYYY-MM-DD HH24:MI:SS'))
*
ERROR at line 1:
ORA-01861: literal does not match format string
Help: https://docs.oracle.com/error-help/db/ora-01861/SELECT VALIDATE_CONVERSION('2026-11-12T14:30:00' AS DATE, 'YYYY-MM-DD HH24:MI:SS') AS space_fmt,
VALIDATE_CONVERSION('2026-11-12T14:30:00' AS DATE, 'YYYY-MM-DD"T"HH24:MI:SS') AS t_fmt
FROM dual; SPACE_FMT T_FMT
---------- ----------
0 1
1 row selected.INSERT INTO api_logs VALUES (1, TO_DATE('2026-11-12T14:30:00', 'YYYY-MM-DD"T"HH24:MI:SS'));
SELECT log_id, TO_CHAR(created_at, 'YYYY-MM-DD HH24:MI:SS') AS created_at FROM api_logs;1 row created.
LOG_ID CREATED_AT
---------- -------------------
1 2026-11-12 14:30:00
1 row selected.3"2026년 12월 25일"처럼 숫자 사이에 글자가 있음
엑셀이나 화면에서 넘어온 2026년 12월 25일 같은 값에는 YYYY-MM-DD에 없는 년, 월, 일이 있어요.
T처럼 그 글자를 형식에 큰따옴표로 넣으면 돼요: YYYY"년" MM"월" DD"일". 일본어 2027年1月1日도 YYYY"年"MM"月"DD"日"로 함께 확인했고, 각각 2026-12-25, 2027-01-01로 들어갔어요.
사전 준비
CREATE TABLE holidays (holiday_id NUMBER PRIMARY KEY, holiday_date DATE);Table created.INSERT INTO holidays VALUES (1, TO_DATE('2026년 12월 25일', 'YYYY-MM-DD'));INSERT INTO holidays VALUES (1, TO_DATE('2026년 12월 25일', 'YYYY-MM-DD'))
*
ERROR at line 1:
ORA-01861: literal does not match format string
Help: https://docs.oracle.com/error-help/db/ora-01861/SELECT VALIDATE_CONVERSION('2026년 12월 25일' AS DATE, 'YYYY-MM-DD') AS plain_fmt,
VALIDATE_CONVERSION('2026년 12월 25일' AS DATE, 'YYYY"년" MM"월" DD"일"') AS quoted_fmt
FROM dual; PLAIN_FMT QUOTED_FMT
---------- ----------
0 1
1 row selected.INSERT INTO holidays VALUES (1, TO_DATE('2026년 12월 25일', 'YYYY"년" MM"월" DD"일"'));
INSERT INTO holidays VALUES (2, TO_DATE('2027年1月1日', 'YYYY"年"MM"月"DD"日"'));
SELECT holiday_id, TO_CHAR(holiday_date, 'YYYY-MM-DD') AS holiday_date FROM holidays ORDER BY holiday_id;1 row created.
1 row created.
HOLIDAY_ID HOLIDAY_DA
---------- ----------
1 2026-12-25
2 2027-01-01
2 rows selected.자주 묻는 질문
WHERE 날짜컬럼 = '2026-11-01' 이 왜 ORA-01861이 나요?
문자열이 세션의 NLS_DATE_FORMAT으로 바뀌는데, 그게 DD-MON-RR이면 YYYY-MM-DD 문자열과 안 맞아요. DATE '2026-11-01'이나 형식을 준 TO_DATE를 쓰세요.
T가 들어간 ISO 8601 날짜는 어떻게 TO_DATE 해요?
형식에서 T를 큰따옴표로 감싸세요: TO_DATE('2026-11-12T14:30:00', 'YYYY-MM-DD"T"HH24:MI:SS').
에러 없이 날짜 형식이 맞는지 미리 확인할 수 있어요?
VALIDATE_CONVERSION('값' AS DATE, '형식')은 바뀌면 1, 안 바뀌면 0을 돌려줘요. 한 쿼리에서 여러 형식을 비교할 수 있어요.
ORA-01861과 ORA-01843은 뭐가 달라요?
ORA-01861은 문자열의 글자 배치 자체가 형식과 안 맞는 것이고, ORA-01843은 배치는 맞는데 월 자리 값이 올바른 월이 아닌 것이에요.
검증 방법
시나리오마다 새 DB 사용자를 만들어 시작해요. 스크립트가 사전 준비 → 에러 재현(에러 코드 일치 확인) → 해결 → 원래 문장 재실행 순서로 실행하고, 화면의 출력은 DB가 실제로 낸 결과를 스크립트가 그대로 저장한 거예요.
lab_a, lab_b는 테스트용 일반 사용자, system은 DBA 계정이에요. Oracle AI Database 26ai Free Release 23.26.3.0.0 - Develop, Learn, and Run for Free