DATENAME (Transact-SQL)

Sintassi

DATENAME (datepart ,date )

Argomenti

• datepart
  Parte dell'elemento date da restituire. Nella tabella seguente vengono elencati tutti gli argomenti di datepart validi. Variabili definite dall'utente equivalenti non sono valide.

  datepart	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
  microsecond	mcs
  nanosecond	ns
  TZoffset	tz

• date
  Espressione che può essere risolta in un valore di tipo time, date, smalldatetime, datetime, datetime2 o datetimeoffset. I valori di tipo date possono essere costituiti da un'espressione, da un'espressione di colonna, da una variabile definita dall'utente o da un valore letterale stringa.

  Per evitare ambiguità, esprimere gli anni nel formato a quattro cifre. Per informazioni sul formato dell'anno a due cifre, vedere Opzione two digit year cutoff.

Tipo restituito

nvarchar

Valore restituito

• Ogni valore datepart e le relative abbreviazioni restituiscono lo stesso valore.

Il valore restituito dipende dalla lingua impostata tramite SET LANGUAGE e dallalingua predefinita dell'account di accesso. Il valore restituito dipende da SET DATEFORMAT se date è un valore letterale stringa di alcuni formati. SET DATEFORMAT non influisce sul valore restituito quando la data è un'espressione di colonna di un tipo di dati ora o data.

Per le versioni di SQL Server successive a SQL Server 2000, quando il parametro date ha un argomento con tipo di dati date, il valore restituito dipende dall'impostazione specificata tramite SET DATEFIRST.

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');

SELECT DATENAME(hour, '2007-06-01')
    ,DATENAME(minute, '2007-06-01')
    ,DATENAME(second, '2007-06-01');

Osservazioni

È possibile utilizzare DATENAME in un elenco di selezione e nelle clausole WHERE, HAVING, GROUP BY e ORDER BY. In SQL Server 2008 DATENAME consente di eseguire il cast in modo implicito di valori letterali stringa come i tipi datetime2. Quando si utilizza DATENAME con DATEADD, evitare cast impliciti di valori letterali stringa. Per ulteriori informazioni, vedere DATEADD (Transact-SQL).

Esempi

Nell'esempio seguente vengono restituite le parti della data per la data specificata.

SELECT DATENAME(datepart,'2007-10-30 12:15:32.1234567 +05:10')

Set di risultati:

Vedere anche

Riferimento