SET DATEFORMAT (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)Ponto de extremidade de análise de SQL no Microsoft FabricDepósito no Microsoft FabricBanco de dados SQL no Microsoft Fabric

Define a ordem das partes do mês, dia e ano para interpretar cadeias de caracteres de data. Essas cadeias de caracteres são do tipo date, smalldatetime, datetime, datetime2 ou datetimeoffset.

Para ter uma visão geral de todas as funções e tipos de dados de data e hora do Transact-SQL, confira Funções e tipos de dados de data e hora (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

SET DATEFORMAT { format | @format_var }   

Argumentos

formato | @format_var
É a ordem das partes de data. Os parâmetros válidos são mdy, dmy, ymd, ydm, myd e dym. Este argumento ou pode ser Unicode ou conjuntos de caracteres de dois bytes (DBCS) convertidos para Unicode. O padrão do inglês dos EUA O padrão em inglês é mdy. Para o padrão DATEFORMAT de todas as linguagens de suporte, veja sp_helplanguage (Transact-SQL).

Comentários

O DATEFORMATydm não é suportado para tipos de dados data,datatime2 e datatimeoffset .

A DATEFORMAT configuração pode interpretar as strings de caracteres de forma diferente para os tipos de dados datados, dependendo do formato da string. Por exemplo, interpretações de datetime e smalldatetime talvez não correspondam a date, datetime2 ou datetimeoffset. DATEFORMAT afeta a interpretação das strings de caracteres à medida que são convertidas para valores de data para o banco de dados. Ele não afeta a exibição de valores de tipo de dados de data, nem ao formato de armazenamento desses valores no banco de dados.

Alguns formatos de string de caracteres, por exemplo ISO 8601, são interpretados independentemente da DATEFORMAT configuração.

A configuração de é definida em tempo de execução ou execução e não em tempo de SET DATEFORMAT análise.

SET DATEFORMAT sobrepõe a configuração implícita de formato de data de SET LANGUAGE.

Permissões

Requer associação à função pública .

Exemplos

O seguinte exemplo usa cadeias de datas diferentes como entradas em sessões com a mesma configuração DATEFORMAT.

-- Set date format to day/month/year.  
SET DATEFORMAT dmy;  
GO  
DECLARE @datevar DATETIME2 = '31/12/2008 09:01:01.1234567';  
SELECT @datevar;  
GO  
-- Result: 2008-12-31 09:01:01.123  
SET DATEFORMAT dmy;  
GO  
DECLARE @datevar DATETIME2 = '12/31/2008 09:01:01.1234567';  
SELECT @datevar;  
GO  
-- Result: Msg 241: Conversion failed when converting date and/or time -- from character string.  
  
GO  

Consulte Também

SET Instruções (Transact-SQL)