data (Transact-SQL)

Artigo
03/07/2014

Define uma data no SQL Server.

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual).

Descrição de data

Propriedade	Valor
Sintaxe	date
Uso	DECLARE @MyDate date CREATE TABLE Table1 ( Column1 date )
Formato literal de cadeia de caracteres padrão (usado para cliente de nível inferior)	AAAA-MM-DD Para obter mais informações, consulte a seção Compatibilidade com versões anteriores a seguir.
Intervalo	0001-01-01 a 9999-12-31 1 de janeiro de 1 d.C. a 31 de dezembro de 9999 d.C.
Intervalos de elementos	AAAA são quatro dígitos de 0001 a 9999 que representam um ano. MM são dois dígitos de 01 a 12 que representam um mês do ano especificado. DD são dois dígitos de 01 a 31, dependendo do mês que representa um dia do mês especificado.
Comprimento de caracteres	10 posições
Precisão, escala	10, 0
Tamanho de armazenamento	3 bytes, fixo.
Estrutura de armazenamento	Um número inteiro de 1, 3 bytes armazena a data.
Precisão	Um dia
Valor padrão	1900-01-01 Este valor é usado para a parte anexada de data utilizada para conversão implícita de time em datetime2 ou datetimeoffset.
Calendário	Gregoriano
Precisão de segundo fracionário definida pelo usuário	Não
Preservação e reconhecimento de deslocamento de fuso horário	Não
Reconhecimento de horário de verão	Não

Formatos de literais de cadeia de caracteres com suporte de data

A tabela a seguir mostra os formatos de literais de cadeia de caracteres válidos para o tipo de dados date.

Numérico	Descrição
mda [m]m/dd/[aa]aa [m]m-dd-[aa]aa [m]m.dd.[aa]aa mad mm/[aa]aa/dd mm-[aa]aa/dd [m]m.[aa]aa.dd dma dd/[m]m/[aa]aa dd-[m]m-[aa]aa dd.[m]m.[aa]aa dam dd/[aa]aa/[m]m dd-[aa]aa-[m]m dd.[aa]aa.[m]m amd [aa]aa/[m]m/dd [aa]aa-[m]m-dd [aa]aa-[m]m-dd	[m]m, dd e [aa]aa representam o mês, o dia e o ano de uma cadeia de caracteres com barras (/), hífens (-), ou pontos (.) como separadores. Somente anos de dois ou quatro dígitos possuem suporte. Use quatro dígitos para o ano sempre que possível. Para especificar um número inteiro de 0001 até 9999 que representa o ano de corte para interpretar anos com dois dígitos e com quatro dígitos, use o Configurar a opção two digit year cutoff de configuração de servidor. Um ano de dois dígitos que é menor ou igual aos últimos dois dígitos do ano de corte está no mesmo século do ano de corte. Um ano de dois dígitos que é maior ou igual aos últimos dois dígitos do ano de corte está no mesmo século que vem antes do ano de corte. Por exemplo, se o ano de corte de dois dígitos for 2049 padrão, o ano de dois dígitos 49 será interpretado como 2049 e o ano de dois dígitos 50 será interpretado como 1950. Os formato padrão de data é determinado pelas configurações atuais de idioma. Você pode alterar o formato da data usando as instruções SET LANGUAGE e SET DATEFORMAT. O formato ydm não tem suporte para date.

mda

[m]m/dd/[aa]aa

[m]m-dd-[aa]aa

[m]m.dd.[aa]aa

mad

mm/[aa]aa/dd

mm-[aa]aa/dd

[m]m.[aa]aa.dd

dma

dd/[m]m/[aa]aa

dd-[m]m-[aa]aa

dd.[m]m.[aa]aa

dam

dd/[aa]aa/[m]m

dd-[aa]aa-[m]m

dd.[aa]aa.[m]m

amd

[aa]aa/[m]m/dd

[aa]aa-[m]m-dd

[m]m, dd e [aa]aa representam o mês, o dia e o ano de uma cadeia de caracteres com barras (/), hífens (-), ou pontos (.) como separadores.

Somente anos de dois ou quatro dígitos possuem suporte. Use quatro dígitos para o ano sempre que possível. Para especificar um número inteiro de 0001 até 9999 que representa o ano de corte para interpretar anos com dois dígitos e com quatro dígitos, use o Configurar a opção two digit year cutoff de configuração de servidor.

Um ano de dois dígitos que é menor ou igual aos últimos dois dígitos do ano de corte está no mesmo século do ano de corte. Um ano de dois dígitos que é maior ou igual aos últimos dois dígitos do ano de corte está no mesmo século que vem antes do ano de corte. Por exemplo, se o ano de corte de dois dígitos for 2049 padrão, o ano de dois dígitos 49 será interpretado como 2049 e o ano de dois dígitos 50 será interpretado como 1950.

Os formato padrão de data é determinado pelas configurações atuais de idioma. Você pode alterar o formato da data usando as instruções SET LANGUAGE e SET DATEFORMAT.

O formato ydm não tem suporte para date.

Alfabético	Descrição
mês [dd][,] aaaa mês dd[,] [aa]aa mês aaaa [dd] [dd] mês[,] aaaa dd mês[,][aa]aa dd [aa]aa mês [dd] aaaa mês aaaa mês [dd] aaaa [dd] mês	mon representa o nome completo do mês ou a abreviação do mês segundo o idioma atual. As vírgulas são opcionais e não há diferenciação entre letras maiúsculas e minúsculas. Para evitar ambiguidade, use anos de quatro dígitos. Se o dia estiver ausente, o primeiro dia do mês será fornecido.

mês [dd][,] aaaa

mês dd[,] [aa]aa

mês aaaa [dd]

[dd] mês[,] aaaa

dd mês[,][aa]aa

dd [aa]aa mês

[dd] aaaa mês

aaaa mês [dd]

aaaa [dd] mês

mon representa o nome completo do mês ou a abreviação do mês segundo o idioma atual. As vírgulas são opcionais e não há diferenciação entre letras maiúsculas e minúsculas.

Para evitar ambiguidade, use anos de quatro dígitos.

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

ISO 8601	Descrição
AAAA-MM-DD AAAAMMDD	Igual ao padrão SQL. Este é o único formato que é definido como padrão internacional.

AAAA-MM-DD

AAAAMMDD

Igual ao padrão SQL. Este é o único formato que é definido como padrão internacional.

Não separado	Descrição
[aa]aammdd aaaa[mm][dd]	Os dados de date podem ser especificados com quatro, seis ou oito dígitos. Uma cadeia de caracteres de seis ou oito dígitos é sempre interpretada como ymd. O mês e o dia sempre devem ser de dois dígitos. Uma cadeia de caracteres de quatro dígitos é interpretada como um ano.

[aa]aammdd

aaaa[mm][dd]

Os dados de date podem ser especificados com quatro, seis ou oito dígitos. Uma cadeia de caracteres de seis ou oito dígitos é sempre interpretada como ymd. O mês e o dia sempre devem ser de dois dígitos. Uma cadeia de caracteres de quatro dígitos é interpretada como um ano.

ODBC	Descrição
{ d 'aaaa-mm-dd' }	Específico à API ODBC.

Formato W3C XML	Descrição
aaaa-mm-ddTZD	Suporte específico para utilização com XML/SOAP. TZD é o designador de fuso horário (Z ou + hh: mm ou -hh:mm): hh:mm representa o deslocamento do fuso horário. hh são dois dígitos, variando de 0 a 14, que representam o número de horas no deslocamento de fuso horário. MM são dois dígitos, variando de 0 a 59, que representam o número de minutos adicionais no deslocamento de fuso horário. + (mais) ou - (menos) é o sinal obrigatório do deslocamento de fuso horário. Ele indica que o deslocamento de fuso horário é adicionado ou subtraído do UTC (Tempo Universal Coordenado) para se obter a hora local. O intervalo válido de deslocamento de fuso horário vai de -14: 00 a +14: 00.

aaaa-mm-ddTZD

Suporte específico para utilização com XML/SOAP.

TZD é o designador de fuso horário (Z ou + hh: mm ou -hh:mm):

hh:mm representa o deslocamento do fuso horário. hh são dois dígitos, variando de 0 a 14, que representam o número de horas no deslocamento de fuso horário.
MM são dois dígitos, variando de 0 a 59, que representam o número de minutos adicionais no deslocamento de fuso horário.
+ (mais) ou - (menos) é o sinal obrigatório do deslocamento de fuso horário. Ele indica que o deslocamento de fuso horário é adicionado ou subtraído do UTC (Tempo Universal Coordenado) para se obter a hora local. O intervalo válido de deslocamento de fuso horário vai de -14: 00 a +14: 00.

Conformidade com ANSI e ISO 8601

date é compatível com a definição padrão ANSI SQL do calendário Gregoriano: “NOTA 85 - Tipos de dados date e time aceitarão que datas no formato Gregoriano sejam armazenadas no intervalo de dados 0001–01–01 CE até 9999–12–31 CE”.

O formato padrão de literais de cadeia de caracteres que é usado para clientes de nível inferior,é compatível com o formato padrão SQL que é definido como AAAA-MM-DD. Este formato é o mesmo da definição ISO 8601 para DATE.

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

Alguns clientes de nível inferior não dão suporte aos 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.

Tipos de dados do SQL Server	Formato de literal de cadeia de caracteres padrão passado ao cliente de nível inferior	ODBC de nível inferior	OLEDB de nível inferior	JDBC de nível inferior	SQLCLIENT de nível inferior
time	hh:mm:ss[. nnnnnnn]	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	Cadeia de caracteres ou SqString
date	AAAA-MM-DD	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	Cadeia de caracteres ou SqString
datetime2	AAAA-MM-DD hh:mm:ss[. nnnnnnn]	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	Cadeia de caracteres ou SqString
datetimeoffset	AAAA-MM-DD hh:mm:ss[. nnnnnnn] [+\|-]hh:mm	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	Cadeia de caracteres ou SqString

Convertendo dados date e time

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

Tipo de dados para converter em	Detalhes da conversão
time(n)	A conversão falha e a mensagem de erro 206 é gerada: "Conflito no tipo de operando: a data é incompatível com a hora".
datetime	A data é copiada e 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-10-25'; DECLARE @datetime datetime= @date; SELECT @date AS '@date', @datetime AS '@datetime'; --Result --@date @datetime ------------ ----------------------- --2025-12-10 2025-12-10 00:00:00.000 -- --(1 row(s) affected)`
smalldatetime	Quando o valor date está no intervalo de uma smalldatetime, o componente de data é copiado e o componente de hora é definido como 00:00:00. Quando o valor date está fora do intervalo de um valor smalldatetime, a mensagem de erro 242 é gerada: "A conversão de um tipo de dados de date em um tipo de dados smalldatetime resulta em um valor fora do intervalo; e o valor smalldatetime é definido como NULL. O código a seguir mostra os resultados da conversão de um valor date em um valor smalldatetime. `DECLARE @date date= '1912-10-25'; DECLARE @smalldatetime smalldatetime = @date; SELECT @date AS '@date', @smalldatetime AS '@smalldatetime'; --Result --@date @smalldatetime ------------ ----------------------- --1912-10-25 1912-10-25 00:00:00 -- --(1 row(s) affected)`
datetimeoffset(n)	A data é copiada e a hora é definida como 00:00.0000000 +00:00. O código a seguir mostra os resultados da conversão de um valor date em um valor datetimeoffset(3). `DECLARE @date date = '1912-10-25'; DECLARE @datetimeoffset datetimeoffset(3) = @date; SELECT @date AS '@date', @datetimeoffset AS '@datetimeoffset'; --Result --@date @datetimeoffset ------------ ------------------------------ --1912-10-25 1912-10-25 00:00:00.000 +00:00 -- --(1 row(s) affected)`
datetime2(n)	O componente de data é copiado e o componente de hora é definido como 00:00:00.00, independentemente do valor de (n). O código a seguir mostra os resultados da conversão de um valor date em um valor datetime2(3). `DECLARE @date date = '1912-10-25'; DECLARE @datetime2 datetime2(3) = @date; SELECT @date AS '@date', @datetime2 AS '@datetime2(3)'; --Result --@date @datetime2(3) ------------ ----------------------- --1912-10-25 1912-10-25 00:00:00.00 -- --(1 row(s) affected)`

Convertendo data em outros tipos de data e hora

A tabela a seguir descreve o que ocorre quando um tipo de dados date é convertido em outros tipos de dados de data e hora.

Tipo de dados para converter em	Detalhes da conversão
time(n)	A conversão falha e a mensagem de erro 206 é gerada: "Conflito no tipo de operando: a data é incompatível com a hora".
datetime	A data é copiada. O código a seguir mostra os resultados da conversão de um valor date em um valor datetime. `DECLARE @date date= '12-10-25'; DECLARE @datetime datetime= @date; SELECT @date AS '@date', @datetime AS '@datetime'; --Result --@date @datetime ------------ ----------------------- --2025-12-10 2025-12-10 00:00:00.000 -- --(1 row(s) affected)`
smalldatetime	Quando o valor date está no intervalo de uma smalldatetime, o componente de data é copiado e o componente de hora é definido como 00:00:00.000. Quando o valor date está fora do intervalo de um valor smalldatetime, a mensagem de erro 242 é gerada: "A conversão de um tipo de dados de data em um tipo de dados smalldatetime resultou em um valor fora do intervalo."; e o valor smalldatetime é definido como NULL. O código a seguir mostra os resultados da conversão de um valor date em um valor smalldatetime. `DECLARE @date date= '1912-10-25'; DECLARE @smalldatetime smalldatetime = @date; SELECT @date AS '@date', @smalldatetime AS '@smalldatetime'; --Result --@date @smalldatetime ------------ ----------------------- --1912-10-25 1912-10-25 00:00:00 -- --(1 row(s) affected)`
datetimeoffset(n)	A data é copiada e a hora é definida como 00:00.0000000 +00:00. O código a seguir mostra os resultados da conversão de um valor date em um valor datetimeoffset(3). `DECLARE @date date = '1912-10-25'; DECLARE @datetimeoffset datetimeoffset(3) = @date; SELECT @date AS '@date', @datetimeoffset AS '@datetimeoffset'; --Result --@date @datetimeoffset ------------ ------------------------------ --1912-10-25 1912-10-25 00:00:00.000 +00:00 -- --(1 row(s) affected)`
datetime2(n)	O componente de data é copiado e o componente de hora é definido como 00:00.000000. O código a seguir mostra os resultados da conversão de um valor date em um valor datetime2(3). `DECLARE @date date = '1912-10-25' DECLARE @datetime2 datetime2(3) = @date; SELECT @date AS '@date', @datetime2 AS '@datetime2(3)'; --Result --@date @datetime2(3) ------------ ----------------------- --1912-10-25 1912-10-25 00:00:00.000 -- --(1 row(s) affected)`

Convertendo cadeias literais em data

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 tempo de execução. As conversões implícitas ou explícitas que não especificam um estilo, de tipos de data e hora em literais de cadeia de caracteres estarã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 date.

Literal de cadeia de caracteres de entrada	date
ODBC DATE	Os literais de cadeia de caracteres de ODBC são mapeados para o tipo de dados datetime. Qualquer operação de atribuição de literais de ODBC DATETIME em um tipo date provocará uma conversão implícita entre datetime e esse tipo conforme definido pelas regras de conversão.
ODBC TIME	Consulte a regra de ODBC DATE anterior.
ODBC DATETIME	Consulte a regra de ODBC DATE anterior.
Apenas DATE	Trivial
Apenas TIME	Os valores padrão são fornecidos.
Apenas TIMEZONE	Os valores padrão são fornecidos.
DATE + TIME	A parte DATE da cadeia de caracteres de entrada é usada.
DATE + TIMEZONE	Não permitido.
TIME + TIMEZONE	Os valores padrão são fornecidos.
DATE + TIME + TIMEZONE	A parte DATE de DATETIME local será usada.

Exemplos

O exemplo a seguir compara os resultados da conversão de uma cadeia de caracteres para cada tipo de dados de data e hora.

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

Aqui está o conjunto de resultados.

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

Consulte também

Referência

CAST e CONVERT (Transact-SQL)

Compartilhar via