DATEPART (SSIS)
Renvoie un entier représentant une partie d'une date.
Syntaxe
DATEPART(datepart, date)
Arguments
datepart
Paramètre qui indique la partie de date pour laquelle il faut retourner une nouvelle valeur.date
Expression renvoyant une date valide ou une chaîne dans un format de date.
Types des résultats
DT_I4
Notes
La fonction DATEPART renvoie un résultat NULL si l'argument est NULL.
Un littéral de date doit être explicitement converti dans l'un des types de données date. Pour plus d'informations, consultez Types de données d'Integration Services.
[!REMARQUE]
La validation de l'expression échoue lorsqu'un littéral de date est explicitement converti en un des types de données de date suivants : DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2, et DT_DBTIME2.
Le tableau suivant décrit les parties de date et les abréviations reconnues par l'évaluateur d'expression. Les noms de partie de date ne respectent pas la casse.
Partie de date |
Abréviations |
|---|---|
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 |
Exemples
L'exemple suivant renvoie l'entier qui représente le mois dans un littéral de date. Si le format de la date est « mm/jj/aaaa », l'exemple renvoie 11.
DATEPART("month", (DT_DBTIMESTAMP)"11/04/2002")
L'exemple suivant renvoie l'entier qui représente le jour dans la colonne ModifiedDate .
DATEPART("dd", ModifiedDate)
L'exemple suivant renvoie l'entier qui représente l'année de la date actuelle.
DATEPART("yy",GETDATE())
Voir aussi