@@DATEFIRST (Transact-SQL)

Retorna o valor atual, para uma sessão, de SET DATEFIRST.

Para obter uma visão geral de todas as funções e tipos de dados de data e hora do Transact-SQL, consulte Funções Date e Time (Transact-SQL). Para obter informações e exemplos que são comuns às funções e tipos de dados de data e hora, consulte Usando dados de data e hora.

Convenções de sintaxe Transact-SQL

Sintaxe

@@DATEFIRST

Tipo de retorno

tinyint

Comentários

SET DATEFIRST especifica o primeiro dia da semana. O padrão inglês dos EUA é 7, domingo.

A configuração desse idioma afeta a interpretação das cadeias de caracteres ao longo da conversão em valores de data para armazenamento no banco de dados, e a exibição dos valores de data armazenados no banco de dados. Essa configuração não afeta o formato de armazenamento de dados de data. No exemplo a seguir, o idioma é definido primeiramente como Italian. A instrução SELECT @@DATEFIRST; retorna 1. O idioma é definido como us_english. A instrução SELECT @@DATEFIRST; retorna 7.

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

Exemplos

O exemplo a seguir 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';

Aqui está o conjunto de resultados.

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

Consulte também

Referência

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