DATEPART (SSIS)
Restituisce un valore integer che rappresenta una parte di una data.
Sintassi
DATEPART(datepart, date)
Argomenti
datepart
Parametro che consente di specificare per quale parte della data si desidera restituire un nuovo valore.date
Espressione che restituisce una data valida o una stringa con formato di data.
Tipi restituiti
DT_I4
Osservazioni
Se l'argomento è Null, DATEPART restituirà Null.
Per i valori letterali di data è necessario eseguire il cast esplicito a uno dei tipi di dati date. Per ulteriori informazioni, vedere Tipi di dati di Integration Services.
[!NOTA]
La convalida dell'espressione non riesce quando viene eseguito il cast esplicito di un valore letterale di data a uno di questi tipi di dati relativi alle date: DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2 e DT_DBTIME2.
Nella tabella seguente sono elencate le parti della data e le abbreviazioni riconosciute dall'analizzatore di espressioni. Per i nomi delle parti della data non viene fatta distinzione tra maiuscole e minuscole.
Parte della data |
Abbreviazioni |
|---|---|
Year |
yy, yyyy |
Quarter |
qq, q |
Month |
mm, m |
Dayofyear |
dy, y |
Day |
dd, d |
Week |
wk, ww |
Weekday |
dw, w |
Hour |
Hh |
Minute |
mi, n |
Second |
ss, s |
Millisecond |
Ms |
Esempi
In questo esempio viene restituito un valore integer che rappresenta il mese in un valore letterale data. Se la data è in formato "mm/gg/aaaa", l'esempio restituirà 11.
DATEPART("month", (DT_DBTIMESTAMP)"11/04/2002")
In questo esempio viene restituito un valore integer che rappresenta il giorno nella colonna ModifiedDate.
DATEPART("dd", ModifiedDate)
In questo esempio viene restituito un valore integer che rappresenta l'anno nella data corrente.
DATEPART("yy",GETDATE())
Vedere anche