Partilhar via

  • Artigo

Suporte a tipos de dados para melhorias de data/hora do OLE DB

Este tópico fornece informações sobre os tipos OLE DB (SQL Server Native Client) que dão suporte aos tipos de dados de data/hora do SQL Server.

Mapeamento de tipos de dados em conjuntos de linhas e parâmetros

O OLE DB fornece dois novos tipos de dados para dar suporte aos novos tipos de servidor: DBTYPE_DBTIME2 e DBTYPE_DBTIMESTAMPOFFSET. A seguinte tabela mostra o mapeamento de tipo do servidor completo:

Tipo de dados SQL Server

Tipo de dados OLE DB

Valor

datetime

DBTYPE_DBTIMESTAMP

135 (oledb.h)

smalldatetime

DBTYPE_DBTIMESTAMP

135 (oledb.h)

date

DBTYPE_DBDATE

133 (oledb.h)

time

DBTYPE_DBTIME2

145 (sqlncli.h)

datetimeoffset

DBTYPE_DBTIMESTAMPOFFSET

146 (sqlncli.h)

datetime2

DBTYPE_DBTIMESTAMP

135 (oledb.h)

Formatos de dados: cadeias e literais

Tipo de dados SQL Server

Tipo de dados OLE DB

Formato de cadeia de caracteres para conversões do cliente

datetime

DBTYPE_DBTIMESTAMP

'aaaa-mm-dd hh:mm:ss[.999]'

O SQL Server oferece suporte a até três dígitos de fração de segundo para Datetime.

smalldatetime

DBTYPE_DBTIMESTAMP

'aaaa-mm-dd hh:mm:ss'

Este tipo de dados tem precisão de um minuto. O componente de segundos será zero na saída, sendo arredondado pelo servidor na entrada.

date

DBTYPE_DBDATE

'aaaa-mm-dd'

time

DBTYPE_DBTIME2

'hh:mm:ss[.9999999]'

Opcionalmente, podem ser especificadas frações de segundo usando até sete dígitos.

datetime2

DBTYPE_DBTIMESTAMP

'aaaa-mm-dd hh:mm:ss[.fffffff]'

Opcionalmente, podem ser especificadas frações de segundo usando até sete dígitos.

datetimeoffset

DBTYPE_DBTIMESTAMPOFFSET

'aaaa-mm-dd hh:mm:ss[.fffffff] +/-hh:mm'

Opcionalmente, podem ser especificadas frações de segundo usando até sete dígitos.

O SQL Server 2008 não introduz nenhuma alteração às seqüências de escape para literais de data/hora.

As frações de segundo nos resultados usam um ponto (.) em vez de um dois-pontos (:).

Valores da cadeia de caracteres passados como retorno aos aplicativos sempre terão o mesmo comprimento para uma determinada coluna. Componentes de ano, mês, dia, hora, minuto e segundo serão preenchidos com zeros à esquerda até seu comprimento máximo. Haverá exatamente um espaço entre a data e a hora e exatamente um espaço entre a hora e o deslocamento de fuso horário. Um deslocamento de fuso horário sempre será precedido de um sinal. Este sinal será positivo (+) quando o deslocamento for zero. Não haverá nenhum espaço em branco entre o sinal e o valor do deslocamento. Frações de segundo serão preenchidas com zero à direita, se necessário, até a precisão definida para a coluna, mas não mais que isso. Para colunas do tipo datetime, haverá três dígitos para frações de segundo. Para colunas do tipo smalldatetime, não haverá nenhum dígito de fração de segundo e os segundos sempre serão zero.

Conversões de valores da cadeia de caracteres fornecidos pelo aplicativo serão mais flexíveis e permitirão valores componentes com comprimento menor que o máximo. Anos podem ter de 1 a 4 dígitos. Meses, dias, horas, minutos e segundos podem ter 1 ou 2 dígitos. Pode haver um espaço em branco arbitrário entre data/hora e hora/deslocamentos de fuso horário. O sinal de um deslocamento com zero horas e zero minutos pode ser mais ou menos. São permitidos zeros à direita para frações de segundo até um máximo de 9 dígitos. Um componente de hora pode terminar com um ponto decimal e não ter dígitos de fração de segundo.

Uma cadeia de caracteres vazia não é um literal de data/hora válido e não representa um valor NULL. Uma tentativa de conversão de uma cadeia de caracteres vazia para um valor de data/hora resultará em erros com SQLState 22018 e a mensagem "Valor de caractere inválido para a especificação de difusão".

Formatos de dados: estruturas de dados

Nas estruturas específicas do OLE DB descritas a seguir, o OLE DB obedece às mesmas restrições que o ODBC. Elas são extraídas do calendário gregoriano:

  • O intervalo de meses é de 1 a 12.

  • O intervalo do campo de dias é de 1 ao número de dias do mês e deve ser coerente com os campos de ano e mês, levando em conta os anos bissextos.

  • O intervalo de horas é de 0 a 23.

  • O intervalo de minutos é de 0 a 59.

  • Isto permite até dois segundos intercalares para manter a sincronização com a hora sideral.

Foram modificadas as implementações dos seguintes structs do OLE DB existentes para dar suporte aos novos tipos de data e hora do SQL Server. Porém, as definições não foram alteradas.

  • DBTYPE_DATE (É um tipo de automação DATE. representado internamente como um double. A parte inteira é o número de dias desde 30 de dezembro de 1899 e a parte fracionária é a fração de um dia. Este tipo tem uma exatidão de 1 segundo, portanto tem uma escala efetiva de 0.)

  • DBTYPE_DBDATE

  • DBTYPE_DBTIME

  • DBTYPE_DBTIMESTAMP (o campo de fração é definido pelo OLE DB como o número de bilionésimos de segundo (nanossegundos) e varia de 0 a 999.999.999)

  • DBTYPE_FILETIME

DBTYPE_DBTIME2

Este struct é novo no SQL Server 2008 e é preenchido até 12 bytes nos sistemas operacionais de 32 e 64 bits.

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

DBTYPE_DBTIMESTAMPOFFSET

Este struct é novo no SQL Server 2008:

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

Se timezone_hour for negativo, timezone_minute deve ser negativo ou zero. Se timezone_hour for positivo, timezone minute deve ser positivo ou zero. Se timezone_hour for zero, timezone minute poderá ter valor entre -59 e +59.

SSVARIANT

Este struct foi modificado no SQL Server 2008 para incluir as novas estruturas DBTYPE_DBTIME2 e DBTYPE_ DBTIMESTAMPOFFSET e para adicionar a escala de frações de segundo para os tipos apropriados.

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;
// ...
   };
};

Além disso, o enum associado à codificação do tipo SSVARIANT, que determina o tipo do enum, será estendida conforme indicado a seguir:

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
};

Aplicativos migrando para o SQL Server 2008 que usam sql_variant e se baseiam na precisão limitada de datetime precisarão ser atualizados se o esquema subjacente for atualizado para usar datetime2 em vez de datetime.

Também foram estendidas as macros de acesso para SSVARIANT com a adição do seguinte:

#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)

Mapeamento de tipo de dados em ITableDefinition::CreateTable

O seguinte mapeamento de tipo é usado com estruturas DBCOLUMNDESC usadas por ITableDefinition::CreateTable:

Tipo de dados do OLE DB (wType)

Tipo de dados do SQL Server

Observações

DBTYPE_DBDATE

date

DBTYPE_DBTIMESTAMP

datetime2(p)

O provedor OLE DB do SQL Server Native Client inspeciona o membro DBCOLUMDESC bScale para determinar a precisão da fração de segundo.

DBTYPE_DBTIME2

time(p)

O provedor OLE DB do SQL Server Native Client inspeciona o membro DBCOLUMDESC bScale para determinar a precisão da fração de segundo.

DBTYPE_DBTIMESTAMPOFFSET

datetimeoffset(p)

O provedor OLE DB do SQL Server Native Client inspeciona o membro DBCOLUMDESC bScale para determinar a precisão da fração de segundo.

Quando um aplicativo especificar DBTYPE_DBTIMESTAMP em wType, pode anular o mapeamento para datetime2 fornecendo um nome de tipo em pwszTypeName. Se datetime for especificado, bScale deverá ser igual a 3. Se smalldatetime for especificado, bScale deverá ser igual a 0. Se bScale não for consistente com wType e pwszTypeName,DB_E_BADSCALE será passado como retorno.

Consulte também

Conceitos

Aprimoramentos de data/hora (OLE DB)