data (Transact-SQL)
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse no Microsoft Fabric
Define uma data no SQL Server.
Descrição de date
| 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 (1582-10-15 a 9999-12-31 para o Informatica) 1º de janeiro de 1 EC (Era Comum) até 31 de dezembro de 9999 EC (15 de outubro de 1582 EC a 31 de dezembro de 9999 EC para Informática) |
| Intervalos de elementos | AAAA são quatro dígitos de 0001 a 9999 que representam um ano. Para o Informatica, YYYY está limitado ao intervalo de 1582 a 9999. 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 representam 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 Esse valor é usado para a parte de data acrescentada 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 compatíveis com date
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 inteiro de 0001 até 9999 que representa o ano de corte para interpretar anos com dois dígitos como de quatro dígitos, use Configurar a opção two digit year cutoff de configuração do servidor. Observação: para o Informatica, YYYY está limitado ao intervalo de 1582 a 9999. 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 maior que os ú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 adm não é compatível com a data. |
| Em ordem alfabética | Descrição |
|---|---|
| mês [dd][,] aaaa mon dd[,] [yy] 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 fornecida no 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 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. |
| ODBCODBC | Descrição |
|---|---|
| { d 'aaaa-mm-dd' } | Específico à API ODBC. |
| Formato W3C XML | Descrição |
|---|---|
| aaaa-mm-ddTZD | Suporte para o uso do XML/SOAP. TZD é o designador de fuso horário (Z ou + hh: mm ou -hh:mm): – hh:mm representa o deslocamento de 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. Esse sinal indica que, para o sistema obter o horário local, o deslocamento de fuso horário é adicionado ao horário UTC (Tempo Universal Coordenado) ou subtraído dele. O intervalo válido de deslocamento de fuso horário vai de -14: 00 a +14: 00. |
Conformidade com o ANSI e ISO 8601
date está em conformidade 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, está em conformidade com o formato padrão SQL definido como AAAA-MM-DD. Este formato é o mesmo da definição ISO 8601 para DATE.
Observação
Para o Informatica, o intervalo é limitado a 1582-10-15 (15 de outubro de 1582 CE) a 9999-12-31 (31 de dezembro de 9999 CE).
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.
| 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 de data e hora
Quando você converte informações em tipos de dados de data e hora, o SQL Server rejeita todos os valores não reconhecidos como datas nem 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).
Convertendo date em outros tipos de data e hora
A tabela a seguir descreve o que ocorre quando você converte um tipo de dados date em outros tipos de dados de data e hora.
Quando a conversão é para time(n) , a conversão falha e mensagem de erro 206 é gerada: "Conflito no tipo de operando: a data é incompatível com a hora".
Se a conversão é feita em 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)
Quando a conversão é feita em uma smalldatetime, o valor de dateestá 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 para tipos 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)
Para a conversão em 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)
Quando a conversão é feita em 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 literais de cadeias de caracteres em data
Se todas as partes das cadeias de caracteres estiverem em formatos válidos, as conversões de literais de cadeia de caracteres em tipos de data e hora serão permitidas. Caso contrário, será gerado um erro de runtime. As conversões implícitas ou explícitas que não especificam um estilo, mas são 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 do ODBC são mapeados para o tipo de dados datetime. Toda operação de atribuição de literais de ODBC DATETIME em um tipo date causa uma conversão implícita entre datetime e o tipo 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';
Este é 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 |
Introduzido pela primeira vez no SQL Server 2008.