DATENAME (Transact-SQL)

Actualizado: 17 de julio de 2006

Devuelve una cadena de caracteres que representa el Datepart especificado de la fecha especificada.

Importante:
Esta característica ha cambiado con respecto a versiones anteriores de SQL Server. Para obtener más información, vea Cambios de comportamiento en las características del motor de base de datos en SQL Server 2005.

Convenciones de sintaxis de Transact-SQL

Sintaxis

DATENAME ( datepart ,date )

Argumentos

• datepart
  Parámetro que especifica la parte de la fecha que se debe devolver. En la tabla siguiente se incluyen las partes de fecha y las abreviaturas reconocidas por Microsoft SQL Server 2005.

  Parte de la fecha	Abreviaturas
  year	yy, yyyy
  quarter	qq, q
  month	mm, m
  dayofyear	dy, y
  day	dd, d
  week	wk, ww
  weekday	dw
  hour	hh
  minute	mi, n
  second	ss, s
  millisecond	ms

  La parte de la fecha weekday (dw) devuelve el día de la semana (domingo, lunes, etc.).

• date
  Es una expresión que devuelve un valor datetime o smalldatetime, o una cadena de caracteres con formato de fecha. Utilice el tipo de datos datetime para fechas posteriores al 1 de enero de 1753. Almacene como datos de caracteres las fechas anteriores. Cuando escriba valores de tipo datetime, inclúyalos siempre entre comillas. Debido a que smalldatetime es exacto sólo en el minuto, cuando se utiliza un valor smalldatetime, los segundos y los milisegundos son siempre 0. Para obtener más información sobre cómo especificar las fechas, vea Date y Time (Transact-SQL). Para obtener más información acerca de cómo especificar valores de hora, vea Formatos de hora.

  Si especifica solamente los dos últimos dígitos del año, los valores menores o iguales que los dos últimos dígitos del valor de la opción de configuración two-digit year cutoff pertenecen al mismo siglo que el año límite. Los valores mayores que los dos últimos dígitos del valor de esta opción se consideran del siglo que precede al año límite. Por ejemplo, si two-digit year cutoff es 2049 (valor predeterminado), 49 se interpreta como 2049 y 50 se interpreta como 1950. Para evitar ambigüedades, utilice años de cuatro dígitos.

Tipos de valor devueltos

nvarchar

Notas

El SQL Server 2005 Database Engine (Motor de base de datos de SQL Server 2005) convierte automáticamente entre valores carácter y datetime cuando es necesario; por ejemplo, cuando compara un valor carácter con un valor datetime.

Ejemplos

En el ejemplo siguiente se extrae el nombre del mes de la fecha devuelta por GETDATE.

SELECT DATENAME(month, GETDATE()) AS 'Month Name';

Éste es el conjunto de resultados.

Month Name

------------------------------

February

En el ejemplo siguiente se extrae el nombre del mes de una columna.

USE AdventureWorks;
GO
SELECT StartDate, DATENAME(month,StartDate) AS StartMonth
FROM Production.WorkOrder
WHERE WorkOrderID = 1;
GO

Éste es el conjunto de resultados.

StartDate StartMonth

-------------------------------- ------------

2001-07-04 00:00:00.000 July

En los siguientes ejemplos se muestra cada argumento de datepart con el argumento de date en este formato: 'YYYY-MM-DDTHH:MM:SS.xxx'.

SELECT DATENAME(year,'1995-10-30 12:15:32.123');
SELECT DATENAME(yy,'1995-10-30 12:15:32.123');
SELECT DATENAME(yyyy,'1995-10-30 12:15:32.123');
-- Return: 1995

SELECT DATENAME(quarter,'1995-10-30 12:15:32.123');
SELECT DATENAME(qq,'1995-10-30 12:15:32.123');
SELECT DATENAME(q,'1995-10-30 12:15:32.123');
-- Return: 4

SELECT DATENAME(month,'1995-10-30 12:15:32.123');
SELECT DATENAME(mm,'1995-10-30 12:15:32.123');
SELECT DATENAME(m,'1995-10-30 12:15:32.123');
-- Return: October

SELECT DATENAME(dayofyear,'1995-10-30 12:15:32.123');
SELECT DATENAME(dy,'1995-10-30 12:15:32.123');
SELECT DATENAME(y,'1995-10-30 12:15:32.123');
-- Return: 303

SELECT DATENAME(day,'1995-10-30 12:15:32.123');
SELECT DATENAME(dd,'1995-10-30 12:15:32.123');
SELECT DATENAME(d,'1995-10-30 12:15:32.123');
-- Return: 30

SELECT DATENAME(week,'1995-10-30 12:15:32.123');
SELECT DATENAME(wk,'1995-10-30 12:15:32.123');
SELECT DATENAME(ww,'1995-10-30 12:15:32.123');
-- Return: 44

SELECT DATENAME(weekday,'1995-10-30 12:15:32.123');
SELECT DATENAME(dw,'1995-10-30 12:15:32.123');
-- Return: Monday

SELECT DATENAME(hour,'1995-10-30 12:15:32.123');
SELECT DATENAME(hour,'1995-10-30 12:15:32.123');
SELECT DATENAME(hh,'10/30/1995 12:15:32.123 PM');
SELECT DATENAME(hh,'10/30/1995 12:15:32.123 PM');
-- Return: 12

SELECT DATENAME(minute,'1995-10-30 12:15:32.123');
SELECT DATENAME(mi,'1995-10-30 12:15:32.123');
SELECT DATENAME(n,'1995-10-30 12:15:32.123');
-- Return: 15
 
SELECT DATENAME(second,'1995-10-30 12:15:32.123');
SELECT DATENAME(ss,'1995-10-30 12:15:32.123');
SELECT DATENAME(s,'1995-10-30 12:15:32.123');
-- Return: 32

SELECT DATENAME(millisecond,'1995-10-30 12:15:32.123');
SELECT DATENAME(ms,'1995-10-30 12:15:32.123');
-- Return: 123

Historial de cambios

Vea también

Referencia

CAST y CONVERT (Transact-SQL)
Tipos de datos (Transact-SQL)
Funciones de fecha y hora (Transact-SQL)

Otros recursos

Formato ISO 8601
Formato alfabético de fecha
Formato numérico de fecha
Formato de fecha y hora de ODBC
Formatos de hora
Formato de cadena sin separar

Ayuda e información

Obtener ayuda sobre SQL Server 2005