發行項
04/02/2012

增強型日期/時間類型的大量複製變更 (OLE DB 和 ODBC)

本主題描述可支援大量複製功能的日期/時間增強功能。本主題中的資訊同時適用於 SQL Server Native Client 中的 OLE DB 和 ODBC。

格式檔案

以互動方式建立格式檔案時，下表描述用於指定日期/時間類型與對應主檔資料類型名稱的輸入。

檔案儲存類型	主檔案資料類型	提示的回應：「請輸入欄位 <field_name> [<default>] 的檔案儲存類型:」
Datetime	SQLDATETIME	d
Smalldatetime	SQLDATETIM4	D
Date	SQLDATE	de
Time	SQLTIME	te
Datetime2	SQLDATETIME2	d2
Datetimeoffset	SQLDATETIMEOFFSET	do

XML 格式檔案 XSD 將具備下列加入項目：

    <xs:complexType name="SQLDATETIME2">
        <xs:complexContent>
            <xs:extension base="bl:Fixed"/>
        </xs:complexContent>
    </xs:complexType>
    <xs:complexType name="SQLDATETIMEOFFSET">
        <xs:complexContent>
            <xs:extension base="bl:Fixed"/>
        </xs:complexContent>
    </xs:complexType>
    <xs:complexType name="SQLDATE">
        <xs:complexContent>
            <xs:extension base="bl:Fixed"/>
        </xs:complexContent>
    </xs:complexType>
    <xs:complexType name="SQLTIME">
        <xs:complexContent>
            <xs:extension base="bl:Fixed"/>
        </xs:complexContent>
    </xs:complexType>

字元資料類型

在字元資料檔中，日期和時間值的表示如 ODBC 之＜資料類型對 ODBC 日期/時間支援的改進＞或 OLE DB 之＜對 OLE DB 日期/時間改善的資料類型支援＞的「資料格式：字串和常值」一節中所述。

在原生資料檔中，四個新類型的日期和時間值會表示為包含 7 個小數位數的 TDS 表示法 (因為這是 SQL Server 所支援的最大值，而且 bcp 資料檔不會儲存這些資料行的小數位數)。現有 datetime 和 smalldatetime 類型的儲存或其表格式資料流 (TDS) 表示法沒有變更。

對於 OLE DB，不同儲存類型的儲存大小如下所示：

檔案儲存類型	儲存體大小 (以位元組為單位)
datetime	8
smalldatetime	4
date	3
time	6
datetime2	9
datetimeoffset	11

ODBC 的大小如下所示。請注意，以任何格式或資料檔儲存有效位數是沒有必要的，因為 BCP.exe 永遠會從伺服器擷取有效位數。

檔案儲存類型	儲存體大小 (以位元組為單位)	儲存體格式
datetime (d)	8	TDS
smalldatetime (D)	4	TDS
date (de)	3	TDS
time (te)	6	TDS
datetime2 (d2)	9	TDS
datetimeoffset (do)	11	TDS

sqlncli.h 中的 BCP 類型

下列類型是在 sqlncli.h 中定義的，可與 ODBC 的 BCP API 延伸模組搭配使用。這些類型在 OLE DB 中，會以 IBCPSession::BCPColFmt 的 eUserDataType 參數傳遞。

檔案儲存類型	主檔案資料類型	在 sqlncli.h 中，搭配 IBCPSession::BCPColFmt 使用的類型	値
Datetime	SQLDATETIME	BCP_TYPE_SQLDATETIME	0x3d
Smalldatetime	SQLDATETIM4	BCP_TYPE_SQLDATETIME4	0x3a
Date	SQLDATE	BCP_TYPE_SQLDATE	0x28
Time	SQLTIME	BCP_TYPE_SQLTIME	0x29
Datetime2	SQLDATETIME2	BCP_TYPE_SQLDATETIME2	0x2a
Datetimeoffset	SQLDATETIMEOFFSET	BCP_TYPE_SQLDATETIMEOFFSET	0x2b

BCP 資料類型轉換

下表提供轉換資訊。

OLE DB 注意：下列轉換是由 IBCPSession 所執行。IRowsetFastLoad 會使用 OLE DB 轉換，如＜從用戶端到伺服器執行的轉換＞中所定義。請注意，datetime 值會捨入為一秒的 1/300，而 smalldatetime 值在執行以下所描述的用戶端轉換之後，會將其秒數設定為零。Datetime 捨入會透過小時和分鐘 (但非日期) 傳播。

To --> From	date	time	smalldatetime	datetime	datetime2	datetimeoffset	char	wchar
Date	1	-	1,6	1,6	1,6	1,5,6	1,3	1,3
Time	N/A	1,10	1,7,10	1,7,10	1,7,10	1,5,7,10	1,3	1,3
Smalldatetime	1,2	1,4,10	1	1	1,10	1,5,10	1,11	1,11
Datetime	1,2	1,4,10	1,12	1	1,10	1,5,10	1,11	1,11
Datetime2	1,2	1,4,10	1,10 (ODBC)1,12 (OLE DB)	1,10	1,10	1,5,10	1,3	1,3
Datetimeoffset	1,2,8	1,4,8,10	1,8,10	1,8,10	1,8,10	1,10	1,3	1,3
Char/wchar (date)	9	-	9,6 (ODBC)9,6,12 (OLE DB)	9,6 (ODBC)9,6,12 (OLE DB)	9,6	9,5,6	N/A	N/A
Char/wchar (time)	-	9,10	9,7,10 (ODBC)9,7,10,12 (OLE DB)	9,7,10 (ODBC)9,7,10, 12 (OLE DB)	9,7,10	9,5,7,10	N/A	N/A
Char/wchar (datetime)	9,2	9,4,10	9,10 (ODBC)9,10,12 (OLE DB)	9,10 (ODBC)9,10,12 (OLE DB)	9,10	9,5,10	N/A	N/A
Char/wchar (datetimeoffset)	9,2,8	9,4,8,10	9,8,10 (ODBC)9,8,10,12 (OLE DB)	9,8,10 (ODBC)9,8,10,12 (OLE DB)	9,8,10	9,10	N/A	N/A

符號的索引鍵

符號	意義
-	不支援轉換。系統會產生含有 SQLSTATE 07006 和訊息「限制的資料類型屬性違規」的 ODBC 診斷記錄。
1	如果提供的資料無效，就會產生含有 SQLSTATE 22007 和訊息「無效的 datetime 格式」的 ODBC 診斷記錄。對於 datetimeoffset 值，即使沒有要求轉換為 UTC，此時間部分在轉換到 UTC 之後仍然必須在範圍內。這是因為 TDS 和伺服器永遠會以 UTC 的 datetimeoffset 值，正規化時間。因此，用戶端必須確認時間元件在轉換為 UTC 之後，仍然位於支援的範圍內。
2	忽略時間元件。
3	對於 ODBC，如果截斷時發生資料遺失，就會產生包含 SQLSTATE 22001 和訊息「字串資料，右邊已截斷」的診斷記錄。系統會根據下表，從目的地資料行的大小決定小數秒位數 (小數位數)。對於大於資料表中範圍的資料行大小，就會隱含小數位數 7。此轉換應該最多允許九個小數秒位數，也就是 ODBC 所允許的最大值。類型隱含的小數位數 0隱含的小數位數 1..7 DBTIME2810,16 DBTIMESTAMP1921..27 DBTIMESTAMPOFFSET2628..34 對於 OLE DB，如果截斷時發生資料損失，則會發佈錯誤。對於 datetime2，小數秒的位數 (小數位數) 會根據下表，從目的地資料行的大小決定。對於大於資料表中範圍的資料行大小，就會隱含小數位數 9。此轉換應該最多允許九個小數秒位數，也就是 OLE DB 所允許的最大值。類型隱含的小數位數 0隱含的小數位數 1..9 DBTIME281..9 DBTIMESTAMP1921..29 DBTIMESTAMPOFFSET2628..36
4	忽略日期元件。
5	時區會設定為 UTC (例如，00:00)。
6	時間會設定為零。
7	日期會設定為 1900-01-01。
8	忽略時區位移。
9	根據出現的第一個標點符號字元以及剩餘的元件是否存在，字串會經過剖析，並轉換為 date、datetime、datetimeoffset 或 time 值。接著，在此程序針對來源類型探索本主題結尾之資料表中的規則之後，此字串會轉換為目標類型。如果剖析提供的資料時一定會發生錯誤，或如果任何元件部分超出允許的範圍之外，或如果沒有從常值類型轉換為目標類型，就會發佈錯誤 (OLE DB)，會產生包含 SQLSTATE 22018 和訊息「轉換規格的字元值無效」的 ODBC 診斷記錄。對於 datetime 和 smalldatetime 參數，如果年份超出這些類型支援的範圍，就會發佈錯誤 (OLE DB)，或產生含有 SQLSATE 22007 和訊息「無效的 datetime 格式」的 ODBC 診斷記錄。對於 datetimeoffset，即使沒有要求轉換為 UTC，此值在轉換到 UTC 之後仍然必須在範圍內。這是因為 TDS 和伺服器永遠會以 UTC 的 datetimeoffset 值，將時間正規化，因此用戶端必須在轉換成 UTC 之後，確認時間元件位於支援的範圍內。如果此值不在支援的 UTC 範圍內，就會發佈錯誤 (OLE DB)，或產生含有 SQLSTATE 22007 和訊息「無效的 datetime 格式」的 ODBC 診斷記錄。
10	如果在從用戶端轉換為伺服器時發生資料遺失的截斷，就會發佈錯誤 (OLE DB)，或產生包含 SQLSTATE 22008 以及「日期時間欄位溢位」訊息的 ODBC 診斷記錄。如果此值落在伺服器使用之 UTC 範圍所代表的範圍外，也可能發生這個錯誤。如果在從伺服器轉換為用戶端時發生秒或小數秒的截斷，只會有一個警告。
11	如果截斷時發生資料損失，則會產生診斷記錄。在伺服器轉換為用戶端時，這是一個警告 (ODBC SQLSTATE S1000)。在用戶端轉換為伺服器時，這是一個錯誤 (ODBC SQLSTATE 22001)。
12	秒數會設定為零，而小數秒會遭到捨棄。不可能發生截斷錯誤。
N/A	系統會維持現有 SQL Server 2005 和舊有的行為。

請參閱

概念

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

日期/時間增強功能 (OLE DB)

共用方式為