發行項
09/24/2010

資料類型對 ODBC 日期/時間支援的改進

本主題提供有關支援 SQL Server 日期和時間資料類型之 ODBC 類型的資訊。

參數和資料列集中的資料類型對應

除了 ODBC 資料類型 (SQL_TYPE_TIMESTAMP 和 SQL_TIMESTAMP) 之外，在 SQL Server Native Client ODBC 中需要兩個新的資料類型，才能公開新的伺服器類型：

SQL_SS_TIME2
SQL_TIMESTAMPOFFSET

下表顯示完整伺服器類型的對應。請注意，資料表的某些資料格包含兩個項目：在這些情況下，第一個是 ODBC 3.0 值，而第二個是 ODBC 2.0 值。

SQL Server 資料類型	SQL 資料類型	値
Datetime	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	93 (sql.h) 11 (sqlext.h)
Smalldatetime	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	93 (sql.h) 11 (sqlext.h)
Date	SQL_TYPE_DATE SQL_DATE	91 (sql.h) 9 (sqlext.h)
Time	SQL_SS_TIME2	-154 (SQLNCLI.h)
DatetimeOFFSET	SQL_SS_TIMESTAMPOFFSET	-155 (SQLNCLI.h)
Datetime2	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	93 (sql.h) 11 (sqlext.h)

下表列出對應的結構和 ODBC C 類型。ODBC 不允許使用定義 C 類型的驅動程式，因此，SQL_C_BINARY 會當做二進位結構，用於 time 和 datetimeoffset。

SQL 資料類型	記憶體配置	預設 C 資料類型	值 (sqlext.h)
SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	SQL_TIMESTAMP_STRUCT TIMESTAMP_STRUCT	SQL_C_TYPE_TIMESTAMP SQL_C_TIMESTAMP	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP
SQL_TYPE_DATE SQL_DATE	SQL_DATE_STRUCT DATE_STRUCT	SQL_C_TYPE_DATE SQL_C_DATE	SQL_TYPE_DATE SQL_DATE
SQL_SS_TIME2	SQL_SS_TIME2_STRUCT	SQL_C_BINARY	SQL_BINARY (-2)
SQL_SS_TIMESTAMPOFFSET	SQL_SS_TIMESTAMPOFFSET_STRUCT	SQL_C_BINARY	SQL_BINARY (-2)

指定 SQL_C_BINARY 繫結時，將會執行對齊檢查，並回報對齊不正確的錯誤。此錯誤的 SQLSTATE 將為 IM016，其中包含「結構對齊錯誤」訊息。

資料格式：字串和常值

下表顯示在 SQL Server 資料類型、ODBC 資料類型與 ODBC 字串常值之間的對應。

SQL Server 資料類型	ODBC 資料類型	用於用戶端轉換的字串格式
Datetime	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	'yyyy-mm-dd hh:mm:ss[.999]' 針對 Datetime，SQL Server 最多支援三個小數秒位數。
Smalldatetime	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	'yyyy-mm-dd hh:hh:ss' 此資料類型的精確度為一分鐘。輸出時，秒數元件為零，而在輸入時，將會由伺服器捨去。
Date	SQL_TYPE_DATE SQL_DATE	'yyyy-mm-dd'
Time	SQL_SS_TIME2	'hh:mm:ss[.9999999]' 您最多可以使用七位數選擇性地指定小數秒。
Datetime2	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	'yyyy-mm-dd hh:mm:ss[.9999999]' 您最多可以使用七位數選擇性地指定小數秒。
DatetimeOFFSET	SQL_SS_TIMESTAMPOFFSET	'yyyy-mm-dd hh:mm:ss[.9999999] +/- hh:mm' 您最多可以使用七位數選擇性地指定小數秒。

日期/時間常值的 ODBC 逸出序列沒有變更。

結果中的小數秒一律使用點 (.) 而非冒號 (:)。

傳回到應用程式的字串值一律為適用於給定資料行的相同長度。年、月、日、十、分和秒元件會以前置零填補以符合最大寬度，而且在 datetime 值的日期和時間之間會有一個空格。在 datetimeoffset 值的時間和時區位移之間也有一個空格。時區位移一律置於一個符號之後；當位移為零時，此符號為加號 (+)。如果需要，小數秒會以尾端零填補，最多填補到針對資料行定義的有效位數。對於 datetime 資料行，有三個小數秒位數。對於 smalldatetime 資料行，則沒有小數秒的位數，而且秒數將永遠為零。

空字串不是有效的日期/時間常值，而且它不代表 NULL 值。嘗試將空字串轉換為日期/時間值時，將會導致 SQLState 22018 錯誤，而且會出現「轉換規格的字元值無效」訊息。

從字串參數進行轉換時，字串格式應該相同，但是小時和分鐘為零的時區符號可以是加號或減號，而且小數秒可以使用最多 9 位數的尾端零。時間元件可以利用一個小數點 (沒有小數秒位數) 結束。

驅動程式目前在標點符號字元周圍允許額外的空白，而時間和時區位移之間的空格則是選擇性的。不過，這在後續的版本中可能會有變更；應用程式不應該依賴目前的行為。

資料格式：資料結構

在以下描述的結構中，ODBC 會指定採用自西曆的下列條件約束：

月份的範圍由 1 至 12。
日期欄位範圍為 1 至該月份的天數，而且如果是潤年，則必須與年和月欄位一致。
小時的範圍由 0 至 23。
分鐘的範圍由 0 至 59。
秒數的範圍由 0 至 61.9(n)。這可讓最多兩個潤秒與恆星時間保持同步。

請注意，SQL Server 不允許使用潤秒，因此，大於 59 的秒數值將會導致伺服器錯誤。

下列現有 ODBC 結構的實作已經經過修改，支援新的 SQL Server 日期和時間資料類型。不過，定義尚未變更。

DATE_STRUCT
TIME_STRUCT
TIMESTAMP_STRUCT

另外還有兩個新的結構：

SQL_SS_TIME2_STRUCT
SQL_SS_TIMESTAMPOFFSET_STRUCT

SQL_SS_TIME2_STRUCT

此結構在 SQL Server 2008 中是新的，而且在 32 位元和 64 位元作業系統上會填補到 12 個位元組。

typedef struct tagSS_TIME2_STRUCT {
   SQLUSMALLINT hour;
   SQLUSMALLINT minute;
   SQLUSMALLINT second;
   SQLUINTEGER fraction;
} SQL_SS_TIME2_STRUCT;

SQL_SS_TIMESTAMPOFFSET_STRUCT

此結構在 SQL Server 2008 中是新的：

typedef struct tagSS_TIMESTAMPOFFSET_STRUCT {
   SQLSMALLINT year;
   SQLUSMALLINT month;
   SQLUSMALLINT day;
   SQLUSMALLINT hour;
   SQLUSMALLINT minute;
   SQLUSMALLINT second;
   SQLUINTEGER fraction;
   SQLSMALLINT timezone_hour;
   SQLSMALLINT timezone_minute;
} SQL_SS_TIMESTAMPOFFSET_STRUCT;

如果 timezone_hour 是負數，timezone_minute 必須為負數或零。如果 timezone_hour 是正數，timezone_minute 必須為正數或零。如果 timezone_hour 為零，timezone_minute 可能擁有 -59 到 +59 範圍內的任何值。

請參閱

概念

ODBC 日期/時間的改善 (ODBC)

共用方式為