SqlDateTime 溢出。必須介於 1/1/1753 12:00:00 AM 和 12/31/9999 11:59:59 PM 之間。
典型場景:匯入資料、實體類別屬性未初始化、或將 DateTime.MinValue 寫入資料庫。
| 屬性 | .NET System.DateTime | SQL Server datetime |
|---|---|---|
| 最小值 | 0001-01-01 00:00:00 | 1753-01-01 00:00:00 |
| 最大值 | 9999-12-31 23:59:59 | 9999-12-31 23:59:59 |
| 精度 | 100 奈秒 (Tick) | 3.33 毫秒 |
當 .NET 端 DateTime.MinValue (或預設 default(DateTime)) 傳入 SQL Server,超出 1753 年下限,引發溢出。
// 取得與 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 範圍:**0001-01-01 至 9999-12-31**,完整對齊 .NET DateTimeDateTime.MinValue,轉為 DBNull.Value (若欄位允許 NULL)SqlDateTime.MinValue (欄位 NOT NULL)DEFAULT 約束未指定時:1900-01-01 00:00:00NULL 至允許 NULL 的 datetime 欄位:儲存 NULL (非預設值)NULL 至 NOT NULL 且有 DEFAULT 的欄位:儲存 1900-01-01datetime vs datetime2SqlDateTime.MinValue 或可為 NullDateTime.MinValue 轉換datetime2 + 參數化查詢