• Articolo

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())