@@DATEFIRST (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

Essa função retorna o valor atual de SET DATEFIRST, para uma sessão específica.

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

Convenções de sintaxe de Transact-SQL

Sintaxe

@@DATEFIRST  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Tipo de retorno

tinyint

Comentários

SET DATEFIRST n Especifica o primeiro dia (DOMINGO, SEGUNDA-FEIRA, TERÇA-FEIRA, etc.) da semana. O valor de n varia de 1 a 7.

SET DATEFIRST 3;
GO  
SELECT @@DATEFIRST; -- 3 (Wednesday)
GO

Para um ambiente em inglês (Estados Unidos), @@DATEFIRST assume o valor 7 (domingo) por padrão.

Essa configuração de idioma afeta a interpretação de cadeia de caracteres, já que o SQL Server converte essas cadeias de caracteres em valores de data para armazenamento de banco de dados. Essa configuração também afeta a exibição de valores de data armazenados no banco de dados. Essa configuração não impacta o formato de armazenamento de dados de data.

Este exemplo primeiro define o idioma para Italian. A instrução SELECT @@DATEFIRST; retorna 1. A próxima instrução define o idioma para é então definido como us_english. A instrução final, SELECT @@DATEFIRST;, retorna 7.

SET LANGUAGE Italian;  
GO  
SELECT @@DATEFIRST;  
GO  
SET LANGUAGE us_english;  
GO  
SELECT @@DATEFIRST;  

Exemplos

Este exemplo define o primeiro dia da semana como 5 (sexta-feira) e assume o dia atual, Today, como sendo sábado. A instrução SELECT retorna o valor DATEFIRST e o número do dia atual da semana.

SET DATEFIRST 5;  
SELECT @@DATEFIRST AS 'First Day'  
    ,DATEPART(dw, SYSDATETIME()) AS 'Today';  

Este é o conjunto de resultados.

First Day         Today  
----------------  --------------  
5                 2  

Exemplo

Azure Synapse Analytics e PDW (Analytics Platform System)

SELECT @@DATEFIRST;  

Confira também

Funções de configuração (Transact-SQL)