datetime (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Define uma data combinada com uma hora do dia que inclui frações de segundos e se baseia em um período de 24 horas.

Descrição

Formatos de literais de cadeia de caracteres com suporte para datetime

As tabelas a seguir listam os formatos de literais de cadeia de caracteres com suporte para datetime. Exceto para ODBC, os literais de cadeia de caracteres datetime estão entre aspas simples ('), por exemplo, 'string_literaL'. Se o ambiente não for us_english, os literais de cadeia de caracteres deverão estar no formato N'string_literaL'.

Arredondando a precisão de segundo fracionário de datetime

Os valores de datetime são arredondados em incrementos de .000, .003 ou .007 segundos, como mostrado na tabela a seguir.

Conformidade com o ANSI e ISO 8601

datetime não está em conformidade com o ANSI nem com o ISO 8601.

Convertendo dados de data e hora

Ao fazer a conversão em tipos de dados de data e hora, SQL Server 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 os dados de data e hora, confira CAST e CONVERT (Transact-SQL).

Converter outros tipos de data e hora no tipo de dados datetime

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

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

DECLARE @date date = '12-21-16';  
DECLARE @datetime datetime = @date;  
  
SELECT @datetime AS '@datetime', @date AS '@date';  
  
--Result  
--@datetime               @date  
------------------------- ----------  
--2016-12-21 00:00:00.000 2016-12-21  

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

DECLARE @date date = '2016-12-21';  
DECLARE @datetime datetime = @date;  

SELECT @datetime AS '@datetime', @date AS '@date';  

Quando a conversão é de time(n), o componente de hora é copiado e o componente de data é definido como '1900-01-01'. Quando a precisão fracionária do valor de time(n) for maior que três dígitos, o valor será truncado para ser ajustado. O exemplo a seguir mostra os resultados da conversão de um valor time(4) em um valor datetime.

DECLARE @time time(4) = '12:10:05.1237';  
DECLARE @datetime datetime = @time;  
  
SELECT @datetime AS '@datetime', @time AS '@time';  
  
--Result  
--@datetime               @time  
------------------------- -------------  
--1900-01-01 12:10:05.123 12:10:05.1237  

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 datetime.

DECLARE @smalldatetime smalldatetime = '12-01-16 12:32';  
DECLARE @datetime datetime = @smalldatetime;  
  
SELECT @datetime AS '@datetime', @smalldatetime AS '@smalldatetime';  
  
--Result  
--@datetime               @smalldatetime  
------------------------- -----------------------  
--2016-12-01 12:32:00.000 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. Quando a precisão fracionária do valor de datetimeoffset(n) for maior que três dígitos, o valor será truncado. O exemplo a seguir mostra os resultados da conversão de um valor datetimeoffset(4) em um valor datetime.

DECLARE @datetimeoffset datetimeoffset(4) = '1968-10-23 12:45:37.1234 +10:0';  
DECLARE @datetime datetime = @datetimeoffset;  
  
SELECT @datetime AS '@datetime', @datetimeoffset AS '@datetimeoffset';  
  
--Result  
--@datetime               @datetimeoffset  
------------------------- ------------------------------  
--1968-10-23 12:45:37.123 1968-10-23 12:45:37.1237 +10:0   

Quando a conversão é de datetime2(n), a data e hora são copiadas. Quando a precisão fracionária do valor de datetime2(n) for maior que três dígitos, o valor será truncado. O exemplo a seguir mostra os resultados da conversão de um valor datetime2(4) em um valor datetime.

DECLARE @datetime2 datetime2(4) = '1968-10-23 12:45:37.1237';  
DECLARE @datetime datetime = @datetime2;  
  
SELECT @datetime AS '@datetime', @datetime2 AS '@datetime2';  
  
--Result  
--@datetime               @datetime2  
------------------------- ------------------------  
--1968-10-23 12:45:37.123 1968-10-23 12:45:37.1237  

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

Este é o conjunto de resultados.

Confira também

CAST e CONVERT (Transact-SQL)