ORA-01861: リテラルが書式文字列と一致しません
ORA-01861: リテラルが書式文字列と一致しませんORA-01861: literal does not match format string日付文字列に、書式にない文字が入っています。
実機検証済みOracle AI Database 26ai Free 23.26.3.0.0 で再現・解決を確認 · 2026-11-12
ORA-01861は、文字列を日付に変換するときに、文字列の文字の並びが書式と合わないと発生します。書式はTO_DATEに指定したもの、指定していなければセッションのNLS_DATE_FORMATです。
エラーは文字列の位置に*を付けるだけで、書式は表示しません。2つを並べて比べてください。文字列にある日付以外の文字(Tや年など)は、書式にも必要です。
原因と対処法
1DATE列を文字列とそのまま比較している
WHERE order_date >= '2026-11-01'はDATEと文字列の比較なので、Oracleは文字列をセッションの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が違うため、このようなSQLはツールでは動いてもアプリでは失敗することがあります。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「2027年1月1日」のように数字の間に文字がある
Excelや画面から来た2027年1月1日のような値には、YYYY-MM-DDにない年・月・日が含まれます。
Tと同じく、その文字を書式にダブルクォートで入れます: YYYY"年"MM"月"DD"日"。再現には韓国語の2026년 12월 25일を使い、同じ方法(YYYY"년" MM"월" DD"일")で直しました。2行とも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を返します。1つのクエリで複数の書式を比べられます。
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