@@DATEFIRST (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

Esta función devuelve el valor actual de SET DATEFIRST para una sesión específica.

Para obtener una introducción sobre todos los tipos de datos y funciones de fecha y hora de Transact-SQL, vea Tipos de datos y funciones de fecha y hora (Transact-SQL).

Convenciones de sintaxis de Transact-SQL

Sintaxis

@@DATEFIRST  

Tipo devuelto

tinyint

Observaciones

SET DATEFIRST n especifica el primer día (DOMINGO, LUNES, MARTES, etc.) de la semana. El valor n puede oscilar entre 1 y 7.

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

Para un entorno de inglés (EE. UU.), el valor predeterminado de @@DATEFIRST es 7 (domingo).

Esta configuración de idioma afecta a la interpretación de cadena de caracteres, ya que SQL Server convierte esas cadenas en valores de fecha para el almacenamiento de base de datos. Esta configuración también afecta a la presentación de los valores de fecha que se almacenan en la base de datos. Esta configuración no afecta al formato de almacenamiento de datos de fecha.

En este ejemplo, primero se establece el idioma en Italian. La instrucción SELECT @@DATEFIRST; devuelve 1. La instrucción siguiente establece el idioma en us_english. La instrucción final SELECT @@DATEFIRST; devuelve 7.

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

Ejemplos

En este ejemplo se establece como primer día de la semana 5 (viernes) y se supone que el día actual, Today, cae en sábado. La instrucción SELECT devuelve el valor de DATEFIRST y el número del día actual de la semana.

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

El conjunto de resultados es el siguiente:

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

Ejemplo

Azure Synapse Analytics y Sistema de la plataforma de análisis (PDW)

SELECT @@DATEFIRST;  

Vea también

Funciones de configuración (Transact-SQL)