Java PreparedStatement 設置日期字段：為何 setString 能寫入 Date 類型列？

使用 PreparedStatement.setString() 向資料庫 DATE 類型欄位寫入字符串 "2016-9-20" 竟能成功，這背後是 JDBC 驅動程式自動完成了類型轉換。

原理解析

1. JDBC 規範：驅動程式負責將 Java 類型映射到 SQL 類型。
2. 隱式轉換：大多數主流驅動（MySQL Connector/J、Oracle JDBC、PostgreSQL JDBC 等）在 setString() 時，若目標列為日期/時間類型，會嘗試解析字符串為對應的 SQL DATE/TIMESTAMP。
3. 解析格式：通常接受 ISO 8601 格式 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss 等，具體視驅動實現而定。

風險與最佳實踐

推薦代碼

String dateStr = "2016-09-20"; // 建議補齊月日雙位數
java.sql.Date sqlDate = java.sql.Date.valueOf(dateStr); // 僅支援 yyyy-MM-dd
// 或使用 LocalDate (Java 8+)
LocalDate localDate = LocalDate.parse(dateStr, DateTimeFormatter.ISO_LOCAL_DATE);
java.sql.Date sqlDate = java.sql.Date.valueOf(localDate);

preparedStatement.setDate(1, sqlDate);

總結

• setString 能寫入 Date 列是驅動層的「便利行為」，非標準保證。
• 生產環境強烈建議使用 setDate / setTimestamp 等強類型方法，配合 java.time 包進行解析與轉換。
• 若必須用字符串，請統一為 yyyy-MM-dd 格式並編寫單元測試驗證目標資料庫驅動行為。