Compartilhar via

datetime (Transact-SQL)

  • Artigo

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.

Evite usar datetime para novos trabalhos. Em vez disso, use os tipos de dados time, date, datetime2 e datetimeoffset. Esses tipos se alinham com o Padrão SQL e são mais portáteis. time, datetime2 e datetimeoffset fornecem mais precisão de segundos. datetimeoffset é compatível com fuso horário para aplicativos implantados globalmente.

Descrição

Propriedade Valor
Sintaxe DATETIME
Uso DECLARE @MyDatetime DATETIME;
CREATE TABLE Table1 (Column1 DATETIME);
Formatos literais de cadeia de caracteres padrão (usados para cliente de nível inferior) Não aplicável
Intervalo de datas 1753-01-01 (1 de janeiro de 1753) até 9999-12-31 (31 de dezembro de 9999)
Intervalo de tempo 00:00:00 a 23:59:59.997
Intervalo de deslocamento de fuso horário Nenhum
Intervalos de elementos yyyy são quatro dígitos de 1753 até 9999 que representam um ano.

MM é dois dígitos, variando de 01 a 12, que representam um mês no ano especificado.

dd é dois dígitos, variando de 01 para 31 dependendo do mês, que representam um dia do mês especificado.

HH são dois dígitos, variando de 00 a 23, que representam a hora.

mm são dois dígitos, variando de 00 a 59, que representam o minuto.

ss é dois dígitos, variando de 00 para 59, que representam o segundo.

n*é de zero a três dígitos, variando de a 999, que representam a fração de 0 segundos.
Comprimento do caractere 19 posições no mínimo e 23 no máximo
Tamanho de armazenamento 8 bytes
Precisão Arredondado para incrementos de .000, .003ou .007 segundos
Valor padrão 1900-01-01 00:00:00
Calendar Gregoriano (inclui a gama completa de anos)
Precisão de segundo fracionário definida pelo usuário Não
Reconhecimento e preservação de deslocamento de fuso horário Não
Aviso de horário de verão Nã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. Com exceção do ODBC, os literais de cadeia de caracteres datetime estão entre aspas simples ('), por exemplo, 'string_literaL'. Se o ambiente não us_englishfor , os literais de cadeia de caracteres devem estar no formato N'string_literaL'Unicode.

Formato numérico

Você pode especificar dados de data com um mês numérico especificado. Por exemplo, 5/20/97 representa o vigésimo dia de maio de 1997. Ao usar o formato de data numérica, especifique o mês, o dia e o ano em uma cadeia de caracteres que use marcas de barra (/), hífens (-) ou pontos (.) como separadores. Essa cadeia de caracteres deve ser exibida da seguinte forma:

<number separator number separator number [time] [time]>

Quando o idioma é definido como us_english, a ordem padrão para a data é mdy (mês, dia, ano). Você pode alterar a ordem da data usando a instrução SET DATEFORMAT.

A configuração para SET DATEFORMAT determina como os valores de data são interpretados. Se a ordem não corresponder à configuração, os valores não serão interpretados como datas. Datas fora de ordem podem ser interpretadas erroneamente como fora do intervalo ou com valores errados. Por exemplo, 12/10/08 pode ser interpretado como uma das seis datas, dependendo da DATEFORMAT configuração. Um ano de quatro partes é interpretado como o ano.

Formato de data Pedido
[0]4/15/[19]96 mdy
[0]4-15-[19]96 mdy
[0]4.15.[19]96 mdy
[0]4/[19]96/15 myd
15/[0]4/[19]96 dmy
15/[19]96/[0]4 dym
[19]96/15/[0]4 ydm
[19]96/[0]4/15 ymd
Formato de hora
14:30
14:30[:20:997]
14:30[:20.9]
4am
4 PM

Formato alfabético

Você pode especificar dados de data com um mês especificado como o nome de mês cheio. Por exemplo, April, ou a abreviação de mês de Apr, especificada no idioma atual. As vírgulas são opcionais e não há diferenciação entre letras maiúsculas e minúsculas.

Aqui estão algumas diretrizes para o uso de formatos de data alfabéticos:

  • Coloque os dados de data e hora entre aspas simples ('). Para outros idiomas que não o inglês, use N''.

  • Os caracteres entre colchetes são opcionais.

  • Se você especificar apenas os dois últimos dígitos do ano, os valores menores que os dois últimos dígitos do valor da opção de configuração de corte de ano de dois dígitos estarão no mesmo século que o ano de corte. Os valores maiores ou iguais ao valor dessa opção estão no século anterior ao ano de corte. Por exemplo, se o corte de dois dígitos do ano for 2050 (padrão), 25 será interpretado como 2025 e 50 será interpretado como 1950. Para evitar ambiguidade, use anos de quatro dígitos.

  • Se o dia estiver ausente, o primeiro dia do mês será fornecido.

  • A SET DATEFORMAT configuração de sessão não é aplicada quando você especifica o mês em forma alfabética.

Em ordem alfabética
Apr[il] [15][,] 1996
Apr[il] 15[,] [19]96
Apr[il] 1996 [15]
[15] Apr[il][,] 1996
15 Apr[il][,][19]96
15 [19]96 apr[il]
[15] 1996 apr[il]
1996 APR[IL] [15]
1996 [15] APR[IL]

Formato ISO 8601

Para usar o formato ISO 8601, você deve especificar cada elemento no formato, incluindo o T, os dois pontos (:) e o ponto (.) que são mostrados no formato.

Os parênteses indicam que o componente de fração de segundo é opcional. O componente de hora é especificado no formato de 24 horas. O T indica o início da parte de hora do valor datetime .

A vantagem em usar o formato ISO 8601 é que é um padrão internacional com especificação inequívoca. Além disso, esse formato não é afetado SET DATEFORMAT pela configuração ou SET LANGUAGE .

Exemplos:

  • 2004-05-23T14:25:10
  • 2004-05-23T14:25:10.487
ISO 8601
yyyy-MM-ddTHH:mm:ss[.mmm]
yyyyMMdd[ HH:mm:ss[.mmm]]

Formato não separado

Esse formato é semelhante ao formato ISO 8601, exceto que não contém separadores de data.

Não separado
yyyyMMdd HH:mm:ss[.mmm]

Formato ODBC

A API ODBC define sequências de escape para representar valores de data e hora que o ODBC chama de dados de carimbo de data/hora. Também há suporte para esse formato de carimbo de data/hora do ODBC na definição de idioma OLE DB (DBGUID-SQL) compatível com o provedor OLE DB do Microsoft para SQL Server. Os aplicativos que usam ADO, OLE DB e as APIs baseadas em ODBC podem usar esse formato de carimbo de data/hora de ODBC para representar datas e horas.

As sequências de escape de carimbo de data/hora ODBC são do formato: { <literal_type> '<constant_value>' }:

  • <literal_type> Especifica o tipo da sequência de escape. Os carimbos de data/hora têm três <literal_type> especificadores:

    • d = somente data
    • t = somente tempo
    • ts = carimbo de data/hora (hora + data)

  • <constant_value> é o valor da sequência de escape. <constant_value> deve seguir estes formatos para cada <literal_type>:

    • d: yyyy-MM-dd
    • t: hh:mm:ss[.fff]
    • ts: yyyy-MM-dd HH:mm:ss[.fff]
ODBC
{ ts '1998-05-02 01:23:56.123' }
{ d '1990-10-02' }
{ t '13:33:41' }

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

Os valores de datetime são arredondados para incrementos de .000, .003ou .007 segundos, conforme mostrado no exemplo a seguir.

SELECT '01/01/2024 23:59:59.999' AS [User-specified value],
    CAST('01/01/2024 23:59:59.999' AS DATETIME) AS [System stored value]
UNION SELECT '01/01/2024 23:59:59.998', CAST('01/01/2024 23:59:59.998' AS DATETIME)
UNION SELECT '01/01/2024 23:59:59.997', CAST('01/01/2024 23:59:59.997' AS DATETIME)
UNION SELECT '01/01/2024 23:59:59.996', CAST('01/01/2024 23:59:59.996' AS DATETIME)
UNION SELECT '01/01/2024 23:59:59.995', CAST('01/01/2024 23:59:59.995' AS DATETIME)
UNION SELECT '01/01/2024 23:59:59.994', CAST('01/01/2024 23:59:59.994' AS DATETIME)
UNION SELECT '01/01/2024 23:59:59.993', CAST('01/01/2024 23:59:59.993' AS DATETIME)
UNION SELECT '01/01/2024 23:59:59.992', CAST('01/01/2024 23:59:59.992' AS DATETIME)
UNION SELECT '01/01/2024 23:59:59.991', CAST('01/01/2024 23:59:59.991' AS DATETIME)
UNION SELECT '01/01/2024 23:59:59.990', CAST('01/01/2024 23:59:59.990' AS DATETIME);

Este é o conjunto de resultados.

Valor especificado pelo usuário Valor armazenado pelo sistema
01/01/2024 23:59:59.999 2024-01-02 00:00:00.000
01/01/2024 23:59:59.998
01/01/2024 23:59:59.997
01/01/2024 23:59:59.996
01/01/2024 23:59:59.995		 2024-01-01 23:59:59.997
01/01/2024 23:59:59.994
01/01/2024 23:59:59.993
01/01/2024 23:59:59.992		 2024-01-01 23:59:59.993
01/01/2024 23:59:59.991
01/01/2024 23:59:59.990		 2024-01-01 23:59:59.990

Conformidade com o ANSI e ISO 8601

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

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 e CONVERT com dados de CAST data e hora, consulte CAST e CONVERT.

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

Este é o conjunto de resultados.

@datetime                @date
------------------------ -----------
2016-12-21 00:00:00.000  2016-12-21

O exemplo anterior usa um formato de data específico da região (MM-DD-YY).

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

Você deve atualizar o exemplo para corresponder ao formato da sua região.

Você também pode completar o exemplo com o formato de data compatível com ISO 8601 (yyyy-MM-dd). Por exemplo:

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 tempo é copiado e o componente de data é definido como 1900-01-01. Quando a precisão fracionária do valor time (n) é maior que três dígitos, o valor é truncado para ajustar. 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';

Este é o conjunto de resultados.

@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 frações de segundos 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';

Este é o conjunto de resultados.

@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 datetimeoffset(n) é maior que três dígitos, o valor é 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';

Este é o conjunto de resultados.

@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 a hora são copiadas. Quando a precisão fracionária do valor datetime2(n) é maior que três dígitos, o valor é 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';

Este é o conjunto de resultados.

@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('2024-05-08 12:35:29.1234567 +12:15' AS TIME(7)) AS 'time',
    CAST('2024-05-08 12:35:29.1234567 +12:15' AS DATE) AS 'date',
    CAST('2024-05-08 12:35:29.123' AS SMALLDATETIME) AS 'smalldatetime',
    CAST('2024-05-08 12:35:29.123' AS DATETIME) AS 'datetime',
    CAST('2024-05-08 12:35:29.1234567 +12:15' AS DATETIME2(7)) AS 'datetime2',
    CAST('2024-05-08 12:35:29.1234567 +12:15' AS DATETIMEOFFSET(7)) AS 'datetimeoffset';

Este é o conjunto de resultados.

Tipo de dados Saída
time 12:35:29.1234567
date 2024-05-08
smalldatetime 2024-05-08 12:35:00
datetime 2024-05-08 12:35:29.123
datetime2 2024-05-08 12:35:29.1234567
datetimeoffset 2024-05-08 12:35:29.1234567 +12:15

Conteúdo relacionado