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, 년 등)는 형식에도 있어야 해요.

원인별 해결 방법

  1. DATE 컬럼을 그냥 문자열과 비교
  2. 날짜와 시간 사이에 T가 있는 ISO 8601 문자열
  3. "2026년 12월 25일"처럼 숫자 사이에 글자가 있음

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번 주문이 조회됐어요.

사전 준비
사전 준비lab_a 계정으로 실행
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;
OUTPUT
Table created.


1 row created.


1 row created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
ALTER SESSION SET NLS_DATE_FORMAT = 'DD-MON-RR';
SELECT order_id FROM orders WHERE order_date >= '2026-11-01';
OUTPUT
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/
확인lab_a 계정으로 실행
ALTER SESSION SET NLS_DATE_FORMAT = 'DD-MON-RR';
SELECT value FROM nls_session_parameters WHERE parameter = 'NLS_DATE_FORMAT';
OUTPUT
Session altered.


VALUE
----------------------------------------------------------------
DD-MON-RR

1 row selected.

세션마다 NLS_DATE_FORMAT이 달라서, 이런 쿼리는 어떤 도구에서는 되고 프로그램에서는 안 되기도 해요. DATE 컬럼은 문자열과 바로 비교하지 마세요.

해결 후 재실행lab_a 계정으로 실행
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;
OUTPUT
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으로 들어갔어요.

사전 준비
사전 준비lab_a 계정으로 실행
CREATE TABLE api_logs (log_id NUMBER PRIMARY KEY, created_at DATE);
OUTPUT
Table created.
재현lab_a 계정으로 실행
INSERT INTO api_logs VALUES (1, TO_DATE('2026-11-12T14:30:00', 'YYYY-MM-DD HH24:MI:SS'));
OUTPUT
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/
확인lab_a 계정으로 실행
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;
OUTPUT
 SPACE_FMT      T_FMT
---------- ----------
         0          1

1 row selected.
해결 후 재실행lab_a 계정으로 실행
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;
OUTPUT
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로 들어갔어요.

사전 준비
사전 준비lab_a 계정으로 실행
CREATE TABLE holidays (holiday_id NUMBER PRIMARY KEY, holiday_date DATE);
OUTPUT
Table created.
재현lab_a 계정으로 실행
INSERT INTO holidays VALUES (1, TO_DATE('2026년 12월 25일', 'YYYY-MM-DD'));
OUTPUT
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/
확인lab_a 계정으로 실행
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;
OUTPUT
 PLAIN_FMT QUOTED_FMT
---------- ----------
         0          1

1 row selected.
해결 후 재실행lab_a 계정으로 실행
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;
OUTPUT
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

관련 에러