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
Versión | Historial |
---|---|
17 de julio de 2006 |
|
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