DATENAME (Transact-SQL)
Devuelve una cadena de caracteres que representa el parámetro datepart especificado del parámetro date especificado.
Para obtener información general acerca de todos los tipos de datos y funciones de fecha y hora de Transact-SQL, consulte Tipos de datos y 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, consulte Usar datos de fecha y hora.
.gif "Icono de vínculo a temas")
Sintaxis
DATENAME (datepart ,date )
Argumentos
datepart
Es una parte de la date que se devuelve. En la siguiente tabla se recogen los argumentos válidos de datepart. Los equivalentes de variables definidas por el usuario no son válidos.datepart
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
microsecond
mcs
nanosecond
ns
TZoffset
tz
date
Es una expresión que se puede resolver como un valor time, date, smalldatetime, datetime, datetime2 o datetimeoffset. date puede ser una expresión, expresión de columna, variable definida por el usuario o literal de cadena.Para evitar la ambigüedad, use años de cuatro dígitos. Parta obtener información sobre los años de dos dígitos, consulte two digit year cutoff (opción).
Tipo devuelto
nvarchar
Valor devuelto
- Cada datepart y sus abreviaturas devuelven el mismo valor.
El valor devuelto depende del entorno del idioma definido por SET LANGUAGE y el idioma predeterminado del inicio de sesión. El valor devuelto depende de SET DATEFORMAT si date es un literal de cadena de ciertos formatos. SET DATEFORMAT no afecta al valor devuelto cuando la fecha es una expresión de columna de un tipo de datos de hora o fecha.
Para las versiones de SQL Server superiores a SQL Server 2000, si el parámetro date tiene un argumento de tipo de datos date, el valor devuelto depende de la configuración especificada mediante SET DATEFIRST.
Argumento datepart TZoffset
Si el argumento datepart es TZoffset (tz) y el argumento date no tiene ajuste de zona horaria, se devuelve 0.
Valor predeterminado devuelto por datepart que no se encuentra en el argumento date
Si el tipo de datos del argumento date no contiene el parámetro datepart especificado, se devolverá el valor predeterminado de datepart.
Por ejemplo, el valor predeterminado de año-mes-día de cualquier tipo de datos date es 1900-01-01. La instrucción siguiente tiene argumentos de la parte de fecha para datepart, un argumento de hora para date y devuelve 1900, January, 1, 1, Monday.
SELECT DATENAME(year, '12:10:30.123')
,DATENAME(month, '12:10:30.123')
,DATENAME(day, '12:10:30.123')
,DATENAME(dayofyear, '12:10:30.123')
,DATENAME(weekday, '12:10:30.123');
El valor predeterminado hora-minuto-segundo para el tipo de datos time es 00:00:00. La instrucción siguiente tiene argumentos de la parte de hora para datepart, un argumento de fecha para date y devuelve 0, 0, 0.
SELECT DATENAME(hour, '2007-06-01')
,DATENAME(minute, '2007-06-01')
,DATENAME(second, '2007-06-01');
Notas
Se puede usar DATENAME en las cláusulas de lista de selección, WHERE, HAVING, GROUP BY y ORDER BY. En SQL Server 2008, DATENAME convierte implícitamente los literales de cadena como tipos datetime2. Cuando utilice DATENAME con DATEADD, evite las conversiones implícitas de literales de cadena. Para obtener más información, vea DATEADD (Transact-SQL).
Ejemplos
En el ejemplo siguiente se devuelven las partes de fecha para la fecha especificada.
SELECT DATENAME(datepart,'2007-10-30 12:15:32.1234567 +05:10')
Éste es el conjunto de resultados.
datepart |
Valor devuelto |
|---|---|
year, yyyy, yy |
2007 |
quarter, qq, q |
4 |
month, mm, m |
Octubre |
dayofyear, dy, y |
303 |
day, dd, d |
30 |
week, wk, ww |
44 |
weekday, dw |
Martes |
hour, hh |
12 |
minute, n |
15 |
second, ss, s |
32 |
millisecond, ms |
123 |
microsecond, mcs |
123456 |
nanosecond, ns |
123456700 |
TZoffset, tz |
310 |