DATENAME (Transact-SQL)

Articolo
12/15/2008

Data aggiornamento: 17 luglio 2006

Restituisce una stringa di caratteri che rappresenta la parte specificata della data indicata.

Importante:
Questa funzionalità è stata modificata rispetto alle versioni precedenti di SQL Server. Per ulteriori informazioni, vedere Differenze di funzionamento delle funzionalità del Motore di database in SQL Server 2005.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

DATENAME ( datepart ,date )

Argomenti

datepart
Parametro che consente di specificare la parte della data da restituire. Nella tabella seguente sono elencate le parti della data e le abbreviazioni riconosciute da Microsoft SQL Server 2005.

Parte della data	Abbreviazioni
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 della data weekday (dw) restituisce il giorno della settimana, ad esempio lunedì, martedì e così via.

date
Espressione che restituisce un valore di tipo datetime o smalldatetime oppure una stringa di caratteri con un formato di data. È possibile utilizzare il tipo di dati datetime solo per date successive al 1° gennaio 1753. Archiviare le date precedenti come dati di tipo carattere. I valori di tipo datetime devono essere sempre racchiusi tra virgolette. Poiché la precisione del tipo di dati smalldatetime è limitata ai minuti, quando si utilizza un valore di tipo smalldatetime, i secondi e i millisecondi sono sempre uguali a 0. Per ulteriori informazioni sull'impostazione delle date, vedere Tipi di dati data/ora (Transact-SQL). Per ulteriori informazioni sull'impostazione dei valori di ora, vedere Formati di ora.

Se si specificano solo le ultime due cifre dell'anno, i valori minori o uguali alle ultime due cifre del valore dell'opzione di configurazione two-digit year cutoff vengono interpretati come appartenenti allo stesso secolo dell'anno di cambio data. I valori maggiori delle ultime due cifre del valore di questa opzione vengono interpretati come appartenenti al secolo precedente a quello dell'anno di cambio data. Ad esempio, se l'opzione two-digit year cutoff è impostata su 2049 (valore predefinito), il valore 49 viene interpretato come 2049 e il valore 50 viene interpretato come 1950. Per evitare ambiguità utilizzare il formato con anno a quattro cifre.

Tipi restituiti

nvarchar

Osservazioni

Motore di database di SQL Server 2005 converte automaticamente i caratteri e i valori di tipo datetime in modo adeguato, ad esempio, quando si confronta un valore di tipo carattere con un valore di tipo datetime.

Esempi

Nell'esempio seguente viene estratto il nome del mese dalla data restituita da GETDATE.

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

Set di risultati:

Month Name

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

February

Nell'esempio seguente viene estratto il nome del mese da una colonna.

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

Set di risultati:

StartDate StartMonth

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

2001-07-04 00:00:00.000 July

Negli esempi seguenti viene illustrato ogni argomento datepart con l'argomento date in formato 'AAAA-MM-GGTHH: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

Cronologia modifiche

Versione	Cronologia
17 luglio 2006	Nuovo contenuto: Aggiunta di esempi.

Vedere anche

Condividi tramite

DATENAME (Transact-SQL)

Sintassi

Argomenti

Tipi restituiti

Osservazioni

Esempi

Cronologia modifiche

Vedere anche

Riferimento

Altre risorse

Guida in linea e informazioni

Risorse aggiuntive