在使用Oracle数据库进行开发时，ORA-01861文字与格式字符串不匹配是非常常见的报错，很多新手遇到这个错误时往往不知道从何下手。下面我们先来看这个报错的典型触发场景，再一步步分析解决方法。
报错产生的原因
ORA-01861的本质是Oracle在尝试把字符串转换为日期类型时，发现字符串的内容和指定的日期格式字符串不匹配，无法完成正确转换。Oracle的日期转换逻辑是严格按照格式字符串解析输入的字符串，只要有一处对应不上就会抛出这个错误。
常见触发场景及解决方法
场景一：插入日期数据时格式不匹配
很多开发者插入日期时会直接写字符串，比如下面这种写法就很可能触发报错：
-- 错误写法，默认日期格式和输入的字符串不匹配时会报错 INSERT INTO test_table (id, create_time) VALUES (1, '2024-05-20 14:30:00');
解决方法是指定明确的日期格式，使用TO_DATE函数转换：
-- 正确写法，明确指定格式字符串
INSERT INTO test_table (id, create_time) VALUES (1, TO_DATE('2024-05-20 14:30:00', 'yyyy-mm-dd hh24:mi:ss'));场景二：查询时日期转换格式错误
查询时如果要对日期字符串做转换，格式不对应也会报错，比如下面的查询：
-- 错误写法，输入的字符串是年月日格式，却用了带时分秒的格式
SELECT * FROM test_table WHERE create_time = TO_DATE('20240520', 'yyyy-mm-dd hh24:mi:ss');只需要把格式字符串和输入的字符串对应上即可：
-- 正确写法，格式和输入字符串匹配
SELECT * FROM test_table WHERE create_time = TO_DATE('20240520', 'yyyymmdd');场景三：会话默认日期格式和传入值不匹配
如果直接传入日期字符串，没有用TO_DATE函数，Oracle会使用会话的默认日期格式NLS_DATE_FORMAT来解析。可以通过下面的语句查看当前会话的默认格式：
-- 查看当前会话默认日期格式
SELECT SYS_CONTEXT('USERENV', 'NLS_DATE_FORMAT') FROM DUAL;如果默认格式是DD-MON-RR，而你传入的是'2024-05-20'，就会触发报错。这种情况可以临时修改会话的默认格式，或者还是用TO_DATE函数指定格式更稳妥：
-- 临时修改当前会话的默认日期格式 ALTER SESSION SET NLS_DATE_FORMAT = 'yyyy-mm-dd hh24:mi:ss'; -- 修改后可以直接插入对应格式的字符串 INSERT INTO test_table (id, create_time) VALUES (2, '2024-05-21 10:15:00');
避坑注意事项
- 所有日期类型数据的插入、转换都尽量显式使用TO_DATE函数，不要依赖默认的会话格式，避免不同环境默认格式不同导致报错。
- 格式字符串里的元素要和输入的字符串严格对应，比如小时如果用24小时制就用hh24，12小时制用hh，分钟是mi不是mm，mm是月份。
- 如果需要对日期做格式化输出，使用TO_CHAR函数，同样要指定正确的格式字符串，避免输出时出现问题。
只要遵循显式指定日期格式的原则，ORA-01861这个报错就可以完全避免，处理日期相关逻辑时也会更清晰可控。
ORA-01861Oracle日期转换TO_DATE函数日期格式字符串NLS_DATE_FORMAT修改时间：2026-06-01 22:05:55