DATENAME (Transact-SQL)

Mis à jour : 17 juillet 2006

Retourne une chaîne de caractères représentant la partie de date précisée de la date spécifiée.

Important :
Cette fonction est différente de celle des précédentes versions de SQL Server. Pour plus d'informations, consultez Changements de comportement des fonctionnalités du moteur de base de données de SQL Server 2005.

Conventions de la syntaxe de Transact-SQL

Syntaxe

DATENAME ( datepart ,date )

Arguments

• datepart
  Paramètre qui indique la partie de la date à retourner. Le tableau suivant répertorie les parties de date et les abréviations reconnues par Microsoft SQL Server 2005.

  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
  hour	hh
  minute	mi, n
  second	ss, s
  millisecond	ms

  La partie de date weekday (dw) retourne le jour de la semaine (dimanche, lundi, etc.).

• date
  Expression qui retourne une valeur datetime ou smalldatetime, ou une chaîne de caractères dans un format de date. Utilisez le type de données datetime pour les dates postérieures au 1er janvier 1753. Stockez en tant que données caractère les dates antérieures. Lorsque vous entrez des valeurs de type datetime, faites-les toujours figurer entre guillemets. La précision des données smalldatetime étant la minute, lorsqu'une valeur smalldatetime est utilisée, les secondes et millièmes de secondes sont toujours égaux à 0. Pour plus d'informations sur la manière de spécifier les dates, consultez Date et Time (Transact-SQL). Pour plus d'informations sur la manière de spécifier les valeurs de temps, consultez Formats d'heure.

  Si vous spécifiez 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 two-digit year cutoff a pour valeur 2049 (valeur par défaut), 49 est interprété comme 2049 et 50 comme 1950. Pour éviter toute ambiguïté, rédigez les années sur quatre chiffres.

Notes

Le moteur de base de données SQL Server 2005 effectue automatiquement la conversion entre les valeurs de types caractère et datetime, si nécessaire. Par exemple, lorsque vous comparez une valeur de type caractère à une valeur de type datetime.

Retourne les types

nvarchar

Exemples

Cet exemple extrait le nom du mois de la date retournée par GETDATE.

SELECT DATENAME(month, GETDATE()) AS 'Month Name';

Voici l'ensemble des résultats.

Month Name

------------------------------

February

Cet exemple extrait le nom du mois d'une colonne.

USE AdventureWorks;
GO
SELECT StartDate, DATENAME(month,StartDate) AS StartMonth
FROM Production.WorkOrder
WHERE WorkOrderID = 1;
GO

Voici l'ensemble des résultats.

StartDate StartMonth

-------------------------------- ------------

2001-07-04 00:00:00.000 July

Les exemples suivants montrent chaque argument datepart avec l'argument date représenté au format « AAAA-MM-JJTHH:MM:SS.xxx ».

SELECT DATENAME(year,'1995-10-30 12:15:32.123');
SELECT DATENAME(yy,'1995-10-30 12:15:32.123');
SELECT DATENAME(yyyy,'1995-10-30 12:15:32.123');
-- Return: 1995

SELECT DATENAME(quarter,'1995-10-30 12:15:32.123');
SELECT DATENAME(qq,'1995-10-30 12:15:32.123');
SELECT DATENAME(q,'1995-10-30 12:15:32.123');
-- Return: 4

SELECT DATENAME(month,'1995-10-30 12:15:32.123');
SELECT DATENAME(mm,'1995-10-30 12:15:32.123');
SELECT DATENAME(m,'1995-10-30 12:15:32.123');
-- Return: October

SELECT DATENAME(dayofyear,'1995-10-30 12:15:32.123');
SELECT DATENAME(dy,'1995-10-30 12:15:32.123');
SELECT DATENAME(y,'1995-10-30 12:15:32.123');
-- Return: 303

SELECT DATENAME(day,'1995-10-30 12:15:32.123');
SELECT DATENAME(dd,'1995-10-30 12:15:32.123');
SELECT DATENAME(d,'1995-10-30 12:15:32.123');
-- Return: 30

SELECT DATENAME(week,'1995-10-30 12:15:32.123');
SELECT DATENAME(wk,'1995-10-30 12:15:32.123');
SELECT DATENAME(ww,'1995-10-30 12:15:32.123');
-- Return: 44

SELECT DATENAME(weekday,'1995-10-30 12:15:32.123');
SELECT DATENAME(dw,'1995-10-30 12:15:32.123');
-- Return: Monday

SELECT DATENAME(hour,'1995-10-30 12:15:32.123');
SELECT DATENAME(hour,'1995-10-30 12:15:32.123');
SELECT DATENAME(hh,'10/30/1995 12:15:32.123 PM');
SELECT DATENAME(hh,'10/30/1995 12:15:32.123 PM');
-- Return: 12

SELECT DATENAME(minute,'1995-10-30 12:15:32.123');
SELECT DATENAME(mi,'1995-10-30 12:15:32.123');
SELECT DATENAME(n,'1995-10-30 12:15:32.123');
-- Return: 15
 
SELECT DATENAME(second,'1995-10-30 12:15:32.123');
SELECT DATENAME(ss,'1995-10-30 12:15:32.123');
SELECT DATENAME(s,'1995-10-30 12:15:32.123');
-- Return: 32

SELECT DATENAME(millisecond,'1995-10-30 12:15:32.123');
SELECT DATENAME(ms,'1995-10-30 12:15:32.123');
-- Return: 123

Historique des modifications

Version	Historique
17 juillet 2006	Nouveau contenu : Ajout des exemples.

Voir aussi

Référence

CAST et CONVERT (Transact-SQL)
Types de données (Transact-SQL)
Fonctions de date et d'heure (Transact-SQL)

Autres ressources

Format ISO 8601
Format de date alphabétique
Format de date numérique
Format de date et d'heure ODBC
Formats d'heure
Format de chaîne non séparée

Aide et Informations

Assistance sur SQL Server 2005