從用戶端到伺服器執行的轉換
適用於：
SQL Server Azure SQL 資料 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)
本文描述在使用 OLE DB Driver for SQL Server 2008 (10.0.x) 和更新版本所撰寫用戶端應用程式之間執行的日期/時間轉換。
轉換
本文描述針對用戶端所進行的轉換。 如果用戶端針對參數所指定的小數秒有效位數與伺服器上所定義的小數秒有效位數不同，在伺服器允許作業成功的情況下，用戶端轉換可能會造成失敗。 明確來說，用戶端會將任何截斷的小數秒視為錯誤，而 SQL Server 會將時間值捨去為最接近的整秒。
如果未呼叫 ICommandWithParameters::SetParameterInfo，就會將 DBTYPE_DBTIMESTAMP 繫結轉換為 datetime2。
| 至 -> 從 |
DBDATE (date) | DBTIME (time) | DBTIME2 (time) | DBTIMESTAMP (smalldatetime) | DBTIMESTAMP (datetime) | DBTIMESTAMP (datetime2) | DBTIMESTAMPOFFSET (datetimeoffset) | STR | WSTR | SQLVARIANT (sql_variant) |
|---|---|---|---|---|---|---|---|---|---|---|
| 日期 | 1, 2 | 1, 3, 4 | 4, 12 | 1, 12 | 1, 12 | 1, 12 | 1, 5, 12 | 1, 12 | 1, 12 | 1, 12 datetime2(0) |
| DBDATE | 1 | - | - | 1, 6 | 1, 6 | 1, 6 | 1, 5, 6 | 1, 10 | 1, 10 | 1 date |
| DBTIME | - | 1 | 1 | 1, 7 | 1, 7 | 1, 7 | 1, 5, 7 | 1, 10 | 1, 10 | 1 Time(0) |
| DBTIME2 | - | 1, 3 | 1 | 1, 7, 10, 14 | 1, 7, 10, 15 | 1, 7, 10 | 1, 5, 7, 10 | 1, 10, 11 | 1, 10, 11 | 1 Time(7) |
| DBTIMESTAMP | 1, 2 | 1, 3, 4 | 1, 4, 10 | 1, 10, 14 | 1, 10, 15 | 1, 10 | 1, 5, 10 | 1, 10,11 | 1, 10, 11 | 1, 10 datetime2(7) |
| DBTIMESTAMPOFFSET | 1, 2, 8 | 1, 3, 4, 8 | 1, 4, 8, 10 | 1, 8, 10, 14 | 1, 8, 10, 15 | 1, 8, 10 | 1, 10 | 1, 10, 11 | 1, 10, 11 | 1, 10 datetimeoffset(7) |
| FILETIME | 1, 2 | 1, 3, 4 | 1, 4, 13 | 1, 13 | 1, 13 | 1, 13 | 1, 5, 13 | 1, 13 | 1, 10 | 1, 13 datetime2(3) |
| BYTES | - | - | - | - | - | - | - | N/A | N/A | N/A |
| VARIANT | 1 | 1 | 1 | 1, 10 | 1, 10 | 1, 10 | 1, 10 | N/A | N/A | 1, 10 |
| SSVARIANT | 1, 16 | 1, 16 | 1, 16 | 1, 10, 16 | 1, 10, 16 | 1, 10, 16 | 1, 10, 16 | N/A | N/A | 1, 16 |
| BSTR | 1, 9 | 1, 9 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | N/A | N/A | N/A |
| STR | 1, 9 | 1, 9 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | N/A | N/A | N/A |
| WSTR | 1, 9 | 1, 9 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | 1, 9, 10 | N/A | N/A | N/A |
符號的索引鍵
| 符號 | 意義 |
|---|---|
| - | 不支援轉換。 如果繫結在呼叫 IAccessor::CreateAccessor 時通過驗證，則會在 rgStatus 中傳回 DBBINDSTATUS_UPSUPPORTEDCONVERSION。 當存取子驗證延遲時，會設定 DBSTATUS_E_BADACCESSOR。 |
| N/A | 不適用。 |
| 1 | 如果提供的資料無效，則會設定 DBSTATUS_E_CANTCONVERTVALUE。 輸入資料會在套用轉換之前進行驗證，因此，即使在後續轉換忽略元件時，該資料仍然必須有效，轉換才會成功。 |
| 2 | 忽略時間欄位。 |
| 3 | 小數秒必須為，否則會設定 DBSTATUS_E_DATAOVERFLOW。 |
| 4 | 忽略日期元件。 |
| 5 | 時區會設定為用戶端的時區設定。 |
| 6 | 時間會設定為零。 |
| 7 | 日期會設定為目前的日期。 |
| 8 | 時間會轉換成 UTC。 如果此轉換期間發生錯誤，則會設定 DBSTATUS_E_CANTCONVERTVALUE。 |
| 9 | 此字串會剖析為 ISO 常值，並轉換為目標類型。 如果失敗，字串會剖析為 OLE 日期常值 (也有時間元件)，並從 OLE 日期 (DBTYPE_DATE) 轉換為目標類型。 如果目標類型為 DBTIMESTAMP、 smalldatetime、 datetime或 datetime2，字串必須符合日期、時間或 datetime2 常值的語法，或者是 OLE 所識別的語法。 如果字串為日期常值，所有時間元件都會設定為零。 如果字串為時間常值，日期會設定目前的日期。 對於其他所有目標類型，字串必須符合目標類型之常值的語法。 |
| 10 | 如果截斷的小數秒發生資料遺失，則會設定 DBSTATUS_E_DATAOVERFLOW。 對於字串轉換，只有在字串符合 ISO 語法時，才能進行溢位檢查。 如果字串為 OLE 日期常值，會捨去小數秒。 若為從 DBTIMESTAMP (datetime) 到 smalldatetime 的轉換，OLE DB Driver for SQL Server 將以無訊息的方式截斷秒數值，而非引發 DBSTATUS_E_DATAOVERFLOW 錯誤。 |
| 11 | 根據下表，小數秒的位數 (小數位數) 會從目的地資料行的大小決定。 對於大於資料表中範圍的資料行大小，會隱含小數位數 9。 此轉換應該最多允許九個小數秒位數，也就是 OLE DB 所允許的最大值。 不過，如果來源類型為 DBTIMESTAMP 而且小數秒為零，則不會產生任何小數秒位數或小數點。 此行為可確保使用舊版 OLE DB 提供者所開發之應用程式的回溯相容性。 資料行大小 ~0 在 OLE DB 中隱含為大小無限制 (除非 DBTIMESTAMP 套用 3 位數規則，否則為 9 位數)。 |
| 12 | 系統會針對 DBTYPE_DATE 維護 SQL Server 2008 (10.0.x) 之前的轉換語意。 小數秒會截斷到零。 |
| 13 | 系統會針對 DBTYPE_FILETIME 維護 SQL Server 2008 (10.0.x) 之前的轉換語意。 如果您使用 Windows FileTimeToSystemTime API，小數秒有效位數會限制為 1 毫秒。 |
| 14 | 系統會針對 smalldatetime 維護 SQL Server 2008 (10.0.x) 之前的轉換語意。 秒數會設定為零。 |
| 15 | 系統會針對 datetime 維護 SQL Server 2008 (10.0.x) 之前的轉換語意。 描述會捨去為第 300 個最接近的秒數。 |
| 16 | 內嵌在 SSVARIANT 用戶端架構中之值 (屬於給定類型) 的轉換行為與未內嵌在 SSVARIANT 用戶端架構時之值和類型的行為相同。 |
| 類型 | 長度 (以字元為單位) | 調整 |
|---|---|---|
| DBTIME2 | 8, 10..18 | 0、1..9 |
| DBTIMESTAMP | 19, 21..29 | 0、1..9 |
| DBTIMESTAMPOFFSET | 26, 28..36 | 0、1..9 |