SET DATEFORMAT (Transact-SQL)

Establece el orden de las partes correspondientes al mes, día y año de una fecha para interpretar las cadenas de caracteres date, smalldatetime, datetime, datetime2 y datetimeoffset.

Para obtener información general sobre todos los tipos de datos y funciones de fecha y hora de Transact-SQL, vea Funciones de fecha y hora (Transact-SQL). Para obtener información y ejemplos comunes a los tipos de datos y funciones de fecha y hora, vea Usar datos de fecha y hora.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL (Transact-SQL)

Sintaxis

SET DATEFORMAT { format | @format_var } 

Argumentos

  • format | **@**format_var
    Es el orden de las partes de la fecha. Los parámetros válidos son mdy, dmy, ymd, ydm, myd y dym. Puede ser Unicode o conjuntos de caracteres de doble byte (DBCS) convertidos a Unicode. El valor predeterminado para Inglés de EE.UU. es mdy. Para DATEFORMAT predeterminado de todos los lenguajes admitidos, vea sp_helplanguage (Transact-SQL).

Comentarios

DATEFORMAT ydm no está admitido para los tipos de datos date, datetime2 y datetimeoffset.

El efecto de la configuración DATEFORMAT en la interpretación de cadenas de caracteres puede ser distinto para los valores datetime y smalldatetime para los valores date, datetime2datetimeoffset, dependiendo del formato de cadena. Esta configuración de idioma afecta a la interpretación de cadenas de caracteres cuando se convierten en valores de fecha para el almacenamiento en la base de datos y la presentación de los valores de fecha que se almacenan en la base de datos. No afecta a la presentación de valores de tipo de datos de fecha que se almacenan en el formato de base de datos o de almacenamiento.

Algunos formatos de cadenas de caracteres, por ejemplo ISO 8601, se interpretan independientemente del valor DATEFORMAT. Para obtener más información sobre cómo utilizar DATEFORMAT con formatos diferentes, vea la sección "Formatos de fecha y tiempo de literales de cadenas" en Utilizar datos de fecha y hora.

La opción SET DATEFORMAT se establece en tiempo de ejecución, no en tiempo de análisis.

SET DATEFORMAT anula la configuración de formato de fecha implícita de SET LANGUAGE.

Permisos

Debe pertenecer a la función public.

Ejemplos

El ejemplo siguiente utiliza cadenas de fecha diferentes como entradas en sesiones con el mismo valor 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

Vea también

Referencia

Conceptos