@@DATEFIRST (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse 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  

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

Veja a seguir 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)