DATENAME (Transact-SQL)
Returns a character string that represents the specified datepart of the specified date
For an overview of all Transact-SQL date and time data types and functions, see Date and Time Data Types and Functions (Transact-SQL).
-
Each datepart and its abbreviations return the same value.
The return value depends on the language environment set by using SET LANGUAGE and by the Configure the default language Server Configuration Option of the login. The return value is dependant on SET DATEFORMAT if date is a string literal of some formats. SET DATEFORMAT does not affect the return value when the date is a column expression of a date or time data type.
When the date parameter has a date data type argument, the return value depends on the setting specified by using SET DATEFIRST.
When date is smalldatetime, seconds are returned as 00.
If the data type of the date argument does not have the specified datepart, the default for that datepart will be returned.
For example, the default year-month-day for any date data type is 1900-01-01. The following statement has date part arguments for datepart, a time argument for date, and returns 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');
The default hour-minute-second for the time data type is 00:00:00. The following statement has time part arguments for datepart, a date argument for date, and returns 0, 0, 0.
SELECT DATENAME(hour, '2007-06-01')
,DATENAME(minute, '2007-06-01')
,DATENAME(second, '2007-06-01');
DATENAME can be used in the select list, WHERE, HAVING, GROUP BY, and ORDER BY clauses.
In SQL Server 2012, DATENAME implicitly casts string literals as a datetime2 type. This means that DATENAME does not support the format YDM when the date is passed as a string. You must explicitly cast the string to a datetime or smalldatetime type to use the YDM format.
The following example returns the date parts for the specified date.
SELECT DATENAME(datepart,'2007-10-30 12:15:32.1234567 +05:10');
Here is the result set.
|
datepart |
Return value |
|---|---|
|
year, yyyy, yy |
2007 |
|
quarter, qq, q |
4 |
|
month, mm, m |
October |
|
dayofyear, dy, y |
303 |
|
day, dd, d |
30 |
|
week, wk, ww |
44 |
|
weekday, dw |
Tuesday |
|
hour, hh |
12 |
|
minute, n |
15 |
|
second, ss, s |
32 |
|
millisecond, ms |
123 |
|
microsecond, mcs |
123456 |
|
nanosecond, ns |
123456700 |
|
TZoffset, tz |
310 |
|
ISO_WEEK, ISOWK, ISOWW |
44 |