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や年など)は、書式にも必要です。

原因と対処法

  1. DATE列を文字列とそのまま比較している
  2. 日付と時刻の間にTがあるISO 8601形式の文字列
  3. 「2027年1月1日」のように数字の間に文字がある

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が取得できました。

事前準備
事前準備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が違うため、このようなSQLはツールでは動いてもアプリでは失敗することがあります。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「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として登録されました。

事前準備
事前準備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を返します。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

関連エラー