Share via


DATEPART (SSIS)

Aktualisiert: 05. Dezember 2005

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.

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

Siehe auch

Verweis

DATEADD (SSIS)
DATEDIFF (SSIS)
DAY (SSIS)
MONTH (SSIS)
YEAR (SSIS)

Andere Ressourcen

Funktionen (SSIS)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version Verlauf

05. Dezember 2005

Neuer Inhalt:
  • Tabelle mit datepart-Werten und den jeweiligen Abkürzungen, die mit der DATEPART-Funktion verwendet werden können, wurde hinzugefügt.