DATENAME (Transact-SQL)

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Questa funzione restituisce una stringa di caratteri che rappresenta l'elemento datepart specificato dell'argomento date indicato.

Per una panoramica di tutti i tipi di dati e funzioni di data e ora Transact-SQL, vedere Funzioni e tipi di dati di data e ora (Transact-SQL).

Convenzioni di sintassi Transact-SQL

Sintassi

DATENAME ( datepart , date )  

Argomenti

datepart
Parte specifica dell'argomento date che verrà restituito da DATENAME. Questa tabella elenca tutti gli argomenti validi per datepart.

date

Espressione che può risolversi in uno dei tipi di dati seguenti:

• date
• datetime
• datetimeoffset
• datetime2
• smalldatetime
• time

Per date, DATENAME accetta un'espressione di colonna, un'espressione, un valore letterale stringa o una variabile definita dall'utente. Per evitare problemi di ambiguità, esprimere gli anni nel formato a quattro cifre. Per informazioni sugli anni a due cifre, vedere Configurare l'opzione di configurazione del server Cambio data per anno a due cifre.

Tipo restituito

nvarchar

Valore restituito

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

Il valore restituito dipende dalla lingua impostata tramite SET LANGUAGE e in Configurare l'opzione di configurazione del server default language dell'account di accesso. Il valore restituito dipende da SET DATEFORMAT se date è un valore letterale stringa di alcuni formati. SET DATEFORMAT non modifica il valore restituito quando la data è un'espressione della colonna di un tipo di dati ora e data.

Quando il parametro date ha un argomento del tipo di dati date, il valore restituito dipende dall'impostazione specificata da SET DATEFIRST.

Argomento datepart TZoffset

Se l'argomento datepart è TZoffset (tz) e l'argomento date non prevede una differenza di fuso orario, DATEADD restituisce 0.

Argomento date smalldatetime

Quando date è smalldatetime, DATENAME restituisce i secondi come 00.

Valore predefinito restituito per un argomento datepart non incluso nell'argomento date

Se per il tipo di dati dell'argomento date non viene specificato datepart, DATENAME restituirà il valore predefinito per datepart solo se l'argomento date ha un valore letterale.

Ad esempio, l'anno-mese-giorno predefinito per qualsiasi tipo di dati date è 1900-01-01. Questa istruzione include gli argomenti datepart per datepart, un argomento time per date e DATENAME restituisce 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');  

Se date viene specificato come variabile o colonna di tabella e per il tipo di dati della variabile o della colonna datepart non viene specificato, DATENAME restituirà l'errore 9810. In questo esempio la variabile @t ha il tipo di dati time. L'esempio ha esito negativo perché la parte della data year non è valida per il tipo di dati time:

DECLARE @t time = '12:10:30.123';   
SELECT DATENAME(year, @t);  

Osservazioni:

Usare DATENAME nelle clausole seguenti:

• GROUP BY
• HAVING
• ORDER BY
• SELECT <list>
• WHERE

In SQL Server, DATENAME consente di eseguire in modo implicito il cast di valori letterali stringa in un tipo datetime2. DATENAME non supporta quindi il formato AGM se la data viene passata come stringa. Per usare il formato AGM è necessario eseguire il cast della stringa in modo esplicito in un tipo datetime o smalldatetime.

Esempi

In questo esempio vengono restituite le parti della data specificata. Sostituire un valore datepart della tabella per l'argomento datepart nell'istruzione SELECT:

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

Questo è il set di risultati.

Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW)

In questo esempio vengono restituite le parti della data specificata. Sostituire un valore datepart della tabella per l'argomento datepart nell'istruzione SELECT:

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

Questo è il set di risultati.

Vedi anche

CAST e CONVERT (Transact-SQL)