Référence de Transact-SQL
DATEPART
Renvoie un entier représentant l'élément de date précisé dans la date spécifiée.
Syntaxe
DATEPART ( datepart , date )
Arguments
datepart
Paramètre qui indique la partie de date à renvoyer. La table suivante répertorie les éléments de date et les abréviations que reconnaît Microsoft® SQL Server.
datepart Abréviations
year yy, yyyy
quart qq, q
month mm, m
dayofyear dy, y
day dd, d
weeek wk, ww
weekday dw
hour hh
minute min
second ss, s
millisecond ms
L'élément de date semaine (wk, ww) reflète les modifications apportées à SET DATEFIRST. Le 1er janvier d'une année définit le nombre de départ de l'élément de date semaine, par exemple : PARTIE_DE_DATE(wk, 'Jan 1, xxxx') = 1, avec xxxx représentant une année quelconque.
L'élément de date weekday (dw) renvoie un nombre correspondant au jour de la semaine, par exemple : Dimanche = 1, samedi = 7. Le nombre obtenu à l'aide de l'élément de date weekday dépend de la valeur configurée par SET DATEFIRST qui définit le premier jour de la semaine.
date
Expression correspondant à une valeur de type datetime ou smalldatetime, ou encore à une chaîne de caractères dans un format de date. N'utilisez le type de données datetime que pour les dates postérieures au 1er janvier 1753. Stockez en tant que données caractère les dates antérieures. Lorsque vous saisissez des valeurs de type datetime, faites-les toujours figurer entre guillemets. Étant donné que la minute est la précision de smalldatetime, en cas d'utilisation d'une valeur smalldatetime, les secondes et les millisecondes sont toujours égales à 0.
Si vous précisez seulement les deux derniers chiffres de l'année, les valeurs inférieures ou égales aux deux derniers chiffres de la valeur de l'option de configuration two digit year cutoff appartiennent au même siècle que l'année de coupure. Les valeurs supérieures aux deux derniers chiffres de la valeur de cette option appartiennent au siècle qui précède l'année de coupure. Par exemple, si l'option coupure des années à deux chiffres a pour valeur 2049 (valeur par défaut), 49 est interprété comme 2049 et 2050 est interprété comme 1950. Pour éviter toute ambiguïté, rédigez les années à l'aide de quatre chiffres.
Pour plus d'informations sur la définition des valeurs horaires, voir Formats d'heure. Pour plus d'informations sur la spécification des dates, voir datetime et smalldatetime.
Type des valeurs renvoyées
int
Notes
Les fonctions DAY, MONTH et YEAR sont synonymes de DATEPART(dd, date), DATEPART(mm, date), et DATEPART(yy, date), respectivement.
Exemple
La fonction GETDATE renvoie la date actuelle. Cependant, la date complète n'est pas toujours l'information requise pour la comparaison (souvent seule une partie de la date fait l'objet d'une comparaison). L'exemple suivant montre les résultats obtenus par les fonctions GETDATE et DATEPART.
SELECT GETDATE() AS 'Current Date'
GO
Voici le jeu de résultats obtenu :
Current Date
---------------------------
Feb 18 1998 11:46PM
SELECT DATEPART(month, GETDATE()) AS 'Month Number'
GO
Voici le jeu de résultats obtenu :
Month Number
------------
2
L'exemple suivant suppose que la date est le 29 mai :
SELECT DATEPART(month, GETDATE())
GO
Voici le jeu de résultats obtenu :
-----------
5
(1 row(s) affected)
Dans cet exemple, la date apparaît comme un nombre. Retenez que, pour SQL Server, 0 est le 1er janvier 1900.
SELECT DATEPART(m, 0), DATEPART(d, 0), DATEPART(yy, 0)
Voici le jeu de résultats obtenu :
----- ------ ------
1 1 1900
Voir aussi
CAST et CONVERT
Types de données
Fonctions de date et d'heure
©1988-2000 Microsoft Corporation. Tous droits réservés.
