datetime2 (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse no Microsoft Fabric

Define uma data combinada com uma hora do dia que se baseia em um período de 24 horas. datetime2 pode ser considerada uma extensão do tipo datetime existente, que tem um intervalo maior de datas, uma precisão fracionária padrão mais ampla e precisão opcional especificada pelo usuário.

Descrição de datetime2

¹ Os valores fornecidos são para rowstore descompactada. O uso de compactação de dados ou columnstore pode alterar o tamanho do armazenamento para cada precisão. Além disso, o tamanho do armazenamento no disco e na memória pode ser diferente. Por exemplo, valores datetime2 sempre exigem 8 bytes em memória quando é usado o modo de lote.

2 Quando um valor datetime2 é convertido em um valor varbinary, um byte extra é adicionado ao valor varbinary para armazenar a precisão.

Para metadados de tipo de dados, consulte sys.systypes ou TYPEPROPERTY. Precisão e escala são variáveis para alguns tipos de data e data/hora. Para obter a precisão e a escala de uma coluna, consulte COLUMNPROPERTY, COL_LENGTH ou sys.columns.

Formatos de literal de cadeia de caracteres compatíveis com datetime2

As tabelas a seguir listam os formatos de literal de cadeia de caracteres ISO 8601 e ODBC para datetime2. Para obter informações sobre formatos alfabéticos, numéricos, não separados e de hora para as partes de data e hora de datetime2, consulte data e hora.

Conformidade com o ANSI e ISO 8601

A conformidade com o ANSI e ISO 8601 de date e time se aplica a datetime2.

Compatibilidade com versões anteriores de clientes de nível inferior

Alguns clientes de nível inferior não são compatíveis com os tipos de dados time, date, datetime2 e datetimeoffset. A tabela a seguir mostra o mapeamento de tipos entre uma instância de nível superior do SQL Server e clientes de nível inferior.

Converter dados de data e hora

Quando você converte em tipos de dados de data e hora, o Mecanismo de Banco de Dados rejeita todos os valores que não pode reconhecer como datas ou horas. Para obter informações sobre como usar as funções CAST e CONVERT com dados de data e hora, consulte CAST e CONVERT

Converter outros tipos de data e hora para o tipo de dados datetime2

Esta seção descreve o que acontece quando outros tipos de dados de data e hora são convertidos no tipo de dados datetime2.

Quando a conversão é de date, o ano, mês e dia são copiados. O componente de hora é definido como 00:00:00.0000000. O código a seguir mostra os resultados da conversão de um valor date em um valor datetime2.

DECLARE @date AS DATE = '12-21-16';

DECLARE @datetime2 AS DATETIME2 = @date;

SELECT @datetime2 AS '@datetime2',
       @date AS '@date';

Veja a seguir o conjunto de resultados.

@datetime2                  @date
--------------------------- ----------
2016-12-21 00:00:00.0000000 2016-12-21

Quando a conversão é de time(n), o componente de tempo é copiado e o componente de data é definido como 1900-01-01. O exemplo a seguir mostra os resultados da conversão de um valor time(7) em um valor datetime2 .

DECLARE @time AS TIME (7) = '12:10:16.1234567';

DECLARE @datetime2 AS DATETIME2 = @time;

SELECT @datetime2 AS '@datetime2',
       @time AS '@time';

Veja a seguir o conjunto de resultados.

@datetime2                  @time
--------------------------- ----------------
1900-01-01 12:10:16.1234567 12:10:16.1234567

Quando a conversão é de smalldatetime, as horas e os minutos são copiados. Os segundos e as frações de segundo são definidos como 0. O código a seguir mostra os resultados da conversão de um valor smalldatetime em um valor datetime2.

DECLARE @smalldatetime AS SMALLDATETIME = '12-01-16 12:32';

DECLARE @datetime2 AS DATETIME2 = @smalldatetime;

SELECT @datetime2 AS '@datetime2',
       @smalldatetime AS '@smalldatetime';

Veja a seguir o conjunto de resultados.

@datetime2                  @smalldatetime
--------------------------- -----------------------
2016-12-01 12:32:00.0000000 2016-12-01 12:32:00

Quando a conversão é de datetimeoffset(n), os componentes de data e hora são copiados. O fuso horário é truncado. O exemplo a seguir mostra os resultados da conversão de um valor datetimeoffset(7) em um valor datetime2.

DECLARE @datetimeoffset AS DATETIMEOFFSET (7) = '2016-10-23 12:45:37.1234567 +10:0';

DECLARE @datetime2 AS DATETIME2 = @datetimeoffset;

SELECT @datetime2 AS '@datetime2',
       @datetimeoffset AS '@datetimeoffset';

Veja a seguir o conjunto de resultados.

@datetime2                  @datetimeoffset
--------------------------- ----------------------------------
2016-10-23 12:45:37.1234567 2016-10-23 12:45:37.1234567 +10:00

Quando a conversão é de datetime, a data e hora são copiadas. A precisão fracionária é estendida para 7 dígitos. O exemplo a seguir mostra os resultados da conversão de um valor datetime em um valor datetime2.

DECLARE @datetime AS DATETIME = '2016-10-23 12:45:37.333';

DECLARE @datetime2 AS DATETIME2 = @datetime;

SELECT @datetime2 AS '@datetime2',
       @datetime AS '@datetime';

Veja a seguir o conjunto de resultados.

@datetime2                  @datetime
----------------------- ---------------------------
2016-10-23 12:45:37.3333333 2016-10-23 12:45:37.333

Converter explicitamente para datetime2 ao usar datetime

No nível de compatibilidade do banco de dados 130 e superior, as conversões implícitas de datetime para datetime2 mostram precisão aprimorada ao contabilizar os milissegundos fracionários, resultando em diferentes valores convertidos, como visto no exemplo anterior. Use a conversão explícita para o tipo de dados datetime2 sempre que existir um cenário de comparação mista entre os tipos de dados datetime e datetime2 . Para obter mais informações, consulte Melhorias no SQL Server e no Banco de Dados SQL do Azure no tratamento de alguns tipos de dados e operações incomuns.

Converter literais de cadeia de caracteres em datetime2

Serão permitidas conversões de literais de cadeia de caracteres para tipos de data e hora se todas as partes da cadeia de caracteres estiverem em formatos válidos. Caso contrário, será gerado um erro de runtime. Conversões implícitas ou conversões explícitas que não especificam um estilo, de tipos de data e hora para literais de cadeia de caracteres, estão no formato padrão da sessão atual. A tabela a seguir mostra as regras de conversão de uma literal de cadeia de caracteres no tipo de dados datetime2.

Exemplos

O exemplo a seguir compara os resultados da conversão de uma cadeia de caracteres em cada tipo de dados date e time.

SELECT CAST ('2007-05-08 12:35:29. 1234567 +12:15' AS TIME (7)) AS 'time',
       CAST ('2007-05-08 12:35:29. 1234567 +12:15' AS DATE) AS 'date',
       CAST ('2007-05-08 12:35:29.123' AS SMALLDATETIME) AS 'smalldatetime',
       CAST ('2007-05-08 12:35:29.123' AS DATETIME) AS 'datetime',
       CAST ('2007-05-08 12:35:29. 1234567 +12:15' AS DATETIME2 (7)) AS 'datetime2',
       CAST ('2007-05-08 12:35:29.1234567 +12:15' AS DATETIMEOFFSET (7)) AS 'datetimeoffset';

Veja a seguir o conjunto de resultados.

Conteúdo relacionado

• CAST e CONVERT (Transact-SQL)