针对 OLE DB 日期/时间改进的数据类型支持

本主题提供有关支持 SQL Server 日期/时间数据类型的 OLE DB (SQL Server Native Client) 类型的信息。

行集和参数中的数据类型映射

OLE DB 提供两种新数据类型来支持新服务器类型：DBTYPE_DBTIME2 和 DBTYPE_DBTIMESTAMPOFFSET。 下表显示全部服务器类型映射：

数据格式：字符串和文字

日期/时间文字的转义序列没有更改。

结果中秒的小数部分使用点 (.)，而不是冒号 (:)。

返回给应用程序的字符串值长度始终与给定列的长度相同。 将使用前导零将年、月、日、小时、分钟和秒部分填充到最大长度。 在日期和时间之间只有一个空格，时间和时区偏移量之间也只有一个空格。 时区偏移量始终带符号。 偏移量为零时，此符号将为正号 (+)。 符号和偏移量值之间没有空格。 必要时将使用尾随零将秒小数部分填充到列的定义精度，但是不会填充更多的零。 对于 datetime 列，秒小数部分有三位数字。 对于 smalldatetime 列，没有秒小数部分，秒始终为零。

从应用程序提供的字符串值转换将更为灵活，允许各个组成部分值小于最大长度。 年可以包含 1-4 位数字。 月、日、小时、分钟和秒可以包含 1 位或 2 位数字。 日期/时间和时间/时区偏移量之间可以有任意多的空格。 零小时零分钟的偏移量符号可以为正号，也可以为负号。 可以为秒小数部分填充尾随零，使之最多达到 9 位数字。 可以使用小数点结束时间部分，不带秒小数部分。

空字符串不是有效的日期/时间文字，它不表示 NULL 值。 尝试将空字符串转换为日期/时间值将导致具有 SQLState 22018 和消息“为转换指定的字符值无效”的错误。

数据格式：数据结构

在以下所述的 OLE DB 特定结构中，OLE DB 遵守与 ODBC 相同的约束。 这些值取自公历：

• “月”范围为从 1 到 12。

• “日”字段范围为 1 到所在月包含的天数，必须与“年”和“月”字段一致，考虑闰年。

• “小时”范围为从 0 到 23。

• “分钟”范围为从 0 到 59。

• 秒范围是 0 到 59。 这允许最多两个闰秒以便与恒星时间保持同步。

已对以下现有 OLE DB 结构的实现进行了修改，以支持新的 SQL Server 日期和时间数据类型。 不过未更改定义。

• DBTYPE_DATE（这是自动化 DATE 类型。 它在内部表示为 double。 整数部分是自 1899 年 12 月 30 日以来的天数，而小数部分是不足一天的部分。 此类型的精确度为 1 秒，因此具有有效的 0 刻度。）

• DBTYPE_DBDATE

• DBTYPE_DBTIME

• DBTYPE_DBTIMESTAMP（小数字段由 OLE DB 定义为秒的十亿分之一（纳秒），范围为 0-999,999,999）

• DBTYPE_FILETIME

DBTYPE_DBTIME2

此结构在 32 位和 64 位操作系统中都填充到 12 个字节。

typedef struct tagDBTIME2 {
    USHORT hour;
    USHORT minute;
    USHORT second;
    ULONG fraction;
    } DBTIME2;

DBTYPE_ DBTIMESTAMPOFFSET

typedef struct tagDBTIMESTAMPOFFSET {
    SHORT year;
    USHORT month;
    USHORT day;
    USHORT hour;
    USHORT minute;
    USHORT second;
    ULONG fraction;
    SHORT timezone_hour;
    SHORT timezone_minute;
    } DBTIMESTAMPOFFSET;

如果 timezone_hour 为负数，timezone_minute 必须为负数或零。 如果 timezone_hour 为正数，timezone minute 必须为正数或零。 如果 timezone_hour 是零，timezone minute 可以取 -59 到 +59 之间的值。

SSVARIANT

此结构现在包括新结构 DBTYPE_DBTIME2 和 DBTYPE_DBTIMESTAMPOFFSET，并为相应类型添加了秒小数部分。

struct SSVARIANT {
   SSVARTYPE vt;
   DWORD dwReserved1;
   DWORD dwReserved2;
   union {
// ...
      DBTIMESTAMP tsDateTimeVal;
      DBDATE dDateVal;
      struct _Time2Val {
         DBTIME2 tTime2Val;
         BYTE bScale;
      } Time2Val;
      struct _DateTimeVal {
         DBTIMESTAMP tsDateTimeVal;
         BYTE bScale;
      } DateTimeVal;
      struct _DateTimeOffsetVal { 
         DBTIMESTAMPOFFSET tsoDateTimeOffsetVal;
         BYTE bScale;
      } DateTimeOffsetVal;
// ...
   };
};

此外，将按以下方式对与 SSVARIANT 类型编码（该编码确定枚举的类型）关联的枚举进行了扩展：

enum SQLVARENUM {
// ...
   // Datetime
   VT_SS_DATETIME      = DBTYPE_DBTIMESTAMP,
   VT_SS_SMALLDATETIME = 206,

   VT_SS_DATE = DBTYPE_DBDATE,
   VT_SS_TIME2 = DBTYPE_DBTIME2,
   VT_SS_DATETIME2 = 212
   VT_SS_DATETIMEOFFSET = DBTYPE_DBTIMESTAMPOFFSET
};

如果将基础架构更新为使用 datetime2 而非 datetime，则使用 sql_variant 并依赖于 datetime 的受限制精度的应用程序在迁移到 SQL Server Native Client 时，必须对它们进行更新。

还通过添加以下内容，对 SSVARIANT 的访问宏进行了扩展：

#define V_SS_DATETIME2(X)       V_SS_UNION(X, DateTimeVal)
#define V_SS_TIME2(X)           V_SS_UNION(X, Time2Val)
#define V_SS_DATE(X)            V_SS_UNION(X, dDateVal)
#define V_SS_DATETIMEOFFSET(X)  V_SS_UNION(X, DateTimeOffsetVal)

ITableDefinition::CreateTable 中的数据类型映射

以下类型映射用于 ITableDefinition::CreateTable 所使用的 DBCOLUMNDESC 结构：

应用程序以 wType 指定 DBTYPE_DBTIMESTAMP 时，它可以通过在 pwszTypeName 中提供类型名称来覆盖到 datetime2 的映射。 如果指定了 datetime，则 bScale 必须为。 如果指定了 smalldatetime，则 bScale 必须为 0。 如果 bScale 与 wType 和 pwszTypeName 不一致，则返回DB_E_BADSCALE。

请参阅

概念

日期/时间改进 (OLE DB)