DATEDIFF (SSIS-kifejezés)

A következőkre vonatkozik:SQL Server SSIS integrációs futtatókörnyezet az Azure Data Factory-ban

A két megadott dátum között keresztezett dátum- és időhatárok számát adja eredményül. A datepart paraméter azonosítja az összehasonlítandó dátum- és időhatárokat.

Szemantika

  
DATEDIFF(datepart, startdate, endate)  

Arguments

datepart
Az a paraméter, amely meghatározza, hogy a dátum melyik részét hasonlítsa össze, és adjon vissza egy értéket.

startdate
Az intervallum kezdő dátuma.

endate
Az intervallum záró dátuma.

Eredménytípusok

DT_I4

Megjegyzések

Az alábbi táblázat a kifejezésértékelő által felismert dátumrészeket és rövidítéseket sorolja fel.

Dátumrész	Abbreviations
Év	yy, yyyy
Negyed	qq, q
Hónap	mm, m
Az év napja	dy, y
Day	dd, d
Week	wk, ww
Hétköznap	dw, w
Óra	Hh
Minute	mi, n
Second	ss, s
Ezredmásodperc	Ms

A DATEDIFF null eredményt ad vissza, ha bármelyik argumentum null.

A dátum kifejezést explicit módon kell átalakítani az egyik dátumadattípusra. További információért lásd: Integrációs Szolgáltatások adattípusai.

Hiba történik, ha egy dátum érvénytelen, ha a dátum vagy az időegység nem sztring, ha a kezdő dátum nem dátum, vagy ha a záró dátum nem dátum.

Ha a záró dátum korábbi, mint a kezdő dátum, a függvény negatív számot ad vissza. Ha a kezdő és a záró dátum egyenlő vagy ugyanabban az intervallumban esik, a függvény nullát ad vissza.

SSIS-kifejezési példák

Ez a példa két dátumkonstans közötti napok számát számítja ki. Ha a dátum "mm/dd/yyyyy" formátumban van, a függvény 7-et ad vissza.

DATEDIFF("dd", (DT_DBTIMESTAMP)"8/1/2003", (DT_DBTIMESTAMP)"8/8/2003")  

Ez a példa egy dátumkonstans és az aktuális dátum közötti hónapok számát adja vissza.

DATEDIFF("mm", (DT_DBTIMESTAMP)"8/1/2003",GETDATE())  

Ez a példa a ModifiedDate oszlopban szereplő dátum és a YearEndDate változó közötti hetek számát adja vissza. Ha a YearEndDatedátum adattípussal rendelkezik, nincs szükség explicit konverzióra.

DATEDIFF("Week", ModifiedDate,@YearEndDate)  

Lásd még:

DATEADD (SSIS-kifejezés)
DATEPART (SSIS-kifejezés)
DAY (SSIS-kifejezés)
HÓNAP (SSIS-kifejezés)
ÉV (SSIS-kifejezés)
Függvények (SSIS-kifejezés)