萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

解決 SqlDateTime 溢出錯誤:.NET DateTime 與 SQL Server datetime 範圍不匹配

錯誤現場

SqlDateTime 溢出。必須介於 1/1/1753 12:00:00 AM 和 12/31/9999 11:59:59 PM 之間。

典型場景:匯入資料、實體類別屬性未初始化、或將 DateTime.MinValue 寫入資料庫。

根因:兩種 DateTime 的範圍差異

屬性.NET System.DateTimeSQL Server datetime
最小值0001-01-01 00:00:001753-01-01 00:00:00
最大值9999-12-31 23:59:599999-12-31 23:59:59
精度100 奈秒 (Tick)3.33 毫秒

當 .NET 端 DateTime.MinValue (或預設 default(DateTime)) 傳入 SQL Server,超出 1753 年下限,引發溢出。

解決方案

方案一:使用 SqlDateTime 結構 (推薦)

// 取得與 SQL datetime 範圍相容的最小值
DateTime sqlMin = (DateTime)System.Data.SqlTypes.SqlDateTime.MinValue;
// 結果:1753-01-01 00:00:00

// 實體類別初始化範例
public class Order {
  public DateTime OrderDate { get; set; } = (DateTime)SqlDateTime.MinValue;
}
注意:SqlDateTime.MinValue 無法隱性轉型為 DateTime,需顯式轉換 (DateTime)SqlDateTime.MinValue 或 Convert.ToDateTime(SqlDateTime.MinValue)。

方案二:改用 datetime2 (SQL Server 2008+)

  • datetime2 範圍:**0001-01-01 至 9999-12-31**,完整對齊 .NET DateTime
  • 精度可達 100 奈秒 (datetime2(7))
  • 儲存體 6-8 bytes (視精度),較 datetime (8 bytes) 更有彈性
  • 新專案建議直接使用 datetime2,根除範圍不匹配問題

方案三:業務邏輯層攔截

  • 資料存取層 (DAL) 攔截 DateTime.MinValue,轉為 DBNull.Value (若欄位允許 NULL)
  • 或轉為 SqlDateTime.MinValue (欄位 NOT NULL)
  • 驗證層攔截未初始化的日期屬性,回傳驗證錯誤而非讓例外上拋

補充知識:SQL Server datetime 預設值

  • 資料庫層級 DEFAULT 約束未指定時:1900-01-01 00:00:00
  • 插入 NULL 至允許 NULL 的 datetime 欄位:儲存 NULL (非預設值)
  • 插入 NULL 至 NOT NULL 且有 DEFAULT 的欄位:儲存 1900-01-01

快速檢核表

  1. ☐ 確認資料表欄位型別:datetime vs datetime2
  2. ☐ 實體類別日期屬性是否初始化為 SqlDateTime.MinValue 或可為 Null
  3. ☐ DAL 是否處理 DateTime.MinValue 轉換
  4. ☐ 匯入資料前驗證日期範圍 (1753-9999 for datetime)
  5. ☐ 新專案優先採用 datetime2 + 參數化查詢
copyright © 萬盛學電腦網 all rights reserved