錯誤現場
INSERT INTO t(dt_col) VALUES ('28-JAN-2023');
-- ORA-01861: literal does not match format string
重裝 OS/Oracle Client 後發生,原本正常的插入失效。
核心機制:Session 日期格式三層優先級
| 層級 | 範圍 | 設定方式 | 優先級 |
| 1. Session 級 | 當前連線 | `ALTER SESSION SET NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'` | 最高 |
| 2. 用戶/Client 環境 | 該用戶所有連線 | Windows 註冊表 `HKLM\SOFTWARE\Oracle\HOME0\NLS_DATE_FORMAT` Linux/Unix 環境變數 `export NLS_DATE_FORMAT=...` | 次之 |
| 3. 資料庫/Instance 級 | 全庫預設 | `NLS_DATE_FORMAT` 參數(不建議動態修改) | 最低 |
**Session 級設定會覆蓋所有上層設定。**
日期存儲與顯示本質
- 資料庫內部儲存:**固定 7 位元組**(世紀、年、月、日、時、分、秒),**無格式、無時區**。
- 顯示格式**完全由 Session NLS 決定**,與儲存無關。
- 插入時若不轉型,**字串必須完全符合當前 Session NLS_DATE_FORMAT** 才能隱式轉型成功。
標準解法:顯式 TO_DATE
-- 無論環境如何,永遠安全
INSERT INTO t(dt_col) VALUES (TO_DATE('2023-01-28 15:30:00','YYYY-MM-DD HH24:MI:SS'));
INSERT INTO t(dt_col) VALUES (TO_DATE('28-JAN-2023','DD-MON-YYYY'));
Client 端永久修正(Windows)
- 開啟 `regedit`。
- 定位 `HKEY_LOCAL_MACHINE\SOFTWARE\Oracle\HOME0`(或 HOME1...)。
- 新增字串值 `NLS_DATE_FORMAT` = `YYYY-MM-DD HH24:MI:SS`。
- 重啟 SQL*Plus / PL/SQL Developer / 應用程式。
Linux/Unix 環境變數法
# ~/.bash_profile 或 /etc/profile
export NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'
export NLS_LANG='AMERICAN_AMERICA.ZHS16GBK' # 字符集一致性
# 重新登入生效
應用程式層面最佳實踐
- **所有日期字串轉型一律使用 `TO_DATE`/`TO_TIMESTAMP` 顯式指定格式**,杜絕隱式轉型。
- 連線池初始化時執行 `ALTER SESSION SET NLS_DATE_FORMAT=...` 統一格式。
- 避免在 SQL 腳本、排程作業中依賴環境預設格式。
快速診斷當前格式
SELECT SYSDATE FROM dual;
-- 輸出即為當前 NLS_DATE_FORMAT 顯示範例
- 上一篇文章: OEM 發現不了資料庫節點?Intelligent Agent 靜態註冊 Listener.ora 缺失排查
- 下一篇文章: Oracle 10g Instant Client 免安裝部署指南:最小檔案集、環境變數、註冊表、ASP.NET 權限
Copyright ©
程式碼之家 All Rights Reserved