• Artikel

DATEPART (SSIS)

Gibt eine ganze Zahl zurück, die einen datepart-Wert eines Datums darstellt.

Syntax

DATEPART(datepart, date)

Argumente

  • datepart
    Der Parameter, der angibt, für welche Datumseinheit ein neuer Wert zurückgegeben werden soll.

  • date
    Ein Ausdruck, der ein gültiges Datum oder eine Zeichenfolge im Datumsformat zurückgibt.

Ergebnistypen

DT_I4

Hinweise

DATEPART gibt ein NULL-Ergebnis zurück, wenn das Argument NULL ist.

Ein Datumsliteral muss explizit in einen der date-Datentypen umgewandelt werden. Weitere Informationen finden Sie unter SQL Server Integration Services-Datentypen.

HinweisHinweis

Der Ausdruck wird nicht überprüft, wenn ein Datumsliteral explizit in einen der folgenden Datumsdatentypen umgewandelt wird: DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2 oder DT_DBTIME2.

In der folgenden Tabelle werden die von der Ausdrucksauswertung erkannten datepart-Werte sowie die jeweiligen Abkürzungen aufgelistet. Bei datepart-Namen wird die Groß-/Kleinschreibung nicht berücksichtigt.

datepart-Wert

Abkürzungen

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

Beispiele

In diesem Beispiel wird die ganze Zahl zurückgegeben, die den Monat in einem Datumsliteral darstellt. Falls das Datum das Format "mm/dd/yyyy" aufweist, wird 11 zurückgegeben.

DATEPART("month", (DT_DBTIMESTAMP)"11/04/2002")

In diesem Beispiel wird die ganze Zahl zurückgegeben, die den Tag in der ModifiedDate-Spalte darstellt.

DATEPART("dd", ModifiedDate)

In diesem Beispiel wird die ganze Zahl zurückgegeben, die das Jahr des aktuellen Datums darstellt.

DATEPART("yy",GETDATE())