Fonction DATE
Retourne la date spécifiée au format datetime.
Syntaxe
DATE(<year>, <month>, <day>)
Paramètres
Terme |
Définition |
|---|---|
year |
Nombre représentant l'année. La valeur de l'argument year peut inclure un à quatre chiffres. L'argument year est interprété conformément au système de date utilisé par votre ordinateur. Les dates à partir du 1er mars 1900 sont prises en charge. Si vous entrez un nombre à virgule, il est arrondi. Pour les valeurs supérieures à 9999 ou inférieures à zéro (valeurs négatives), la fonction retourne une erreur #VALUE!. Si la valeur de year est comprise entre 0 et 1899, elle est ajoutée à 1900 pour fournir la valeur finale. Consultez les exemples ci-dessous.
|
month |
Nombre qui représente le mois ou un calcul conforme aux règles suivantes : Si month est un nombre compris entre 1 et 12, il représente un mois de l'année. 1 représente janvier, 2 représente février, et ainsi de suite jusqu'à 12 qui représente décembre. Si vous entrez un entier supérieur à 12, le calcul suivant est effectué : la date est calculée en ajoutant la valeur de month à la valeur de year. Par exemple, si vous avez la DATE( 2008, 18, 1), la fonction retourne une valeur datetime équivalente au 1er juin 2009, parce que 18 mois sont ajoutés au début de 2008, ce qui équivaut à juin 2009. Consultez les exemples ci-dessous. Si vous entrez un entier négatif, le calcul suivant est effectué : la date est calculée en soustrayant la valeur de month à la valeur de year. Par exemple, si vous avez DATE( 2008, -6, 15), la fonction retourne une valeur datetime équivalente au 15 juin 2007, parce qu'en soustrayant 6 mois au début de 2008, on obtient une valeur correspondant à juin 2007. Consultez les exemples ci-dessous. |
day |
Nombre qui représente le jour ou un calcul conforme aux règles suivantes : Si day est un nombre compris entre 1 et le dernier jour du mois donné, il représente un jour du mois. Si vous entrez un entier supérieur au dernier jour du mois donné, le calcul suivant est effectué : la date est calculée en ajoutant la valeur de day à la valeur de month. Par exemple, dans la formule DATE( 2008, 3, 32), la fonction DATE retourne une valeur datetime équivalente au 1er avril 2008, parce qu'en ajoutant 32 jours au début du mois de mars, on obtient le 1er avril. Si vous entrez un entier négatif, le calcul suivant est effectué : la date est calculée en soustrayant la valeur de day de la valeur de month. Par exemple, dans la formule DATE( 2008, 5, -15), la fonction DATE retourne une valeur datetime équivalente au 15 avril 2008, parce qu'en soustrayant 15 jours du début du mois de mai 2008, on obtient une valeur correspondant au mois d'avril 2008. Si day contient une partie décimale, la valeur est arrondie à la valeur entière la plus proche. |
Valeur de retour
Retourne la date spécifiée (datetime)).
Notes
La fonction DATE prend les entiers entrés comme arguments et génère la date correspondante. La fonction DATE est très utile dans les situations où l'année, le mois et le jour sont fournis par des formules. Par exemple, les données sous-jacentes peuvent contenir des dates dans un format qui n'est pas reconnu comme une date, tel que AAAAMMJJ. Vous pouvez utiliser la fonction DATE avec d'autres fonctions pour convertir une date en nombre qui peut être reconnu comme une date.
Contrairement à Microsoft Excel, qui stocke les dates en tant que numéros de série, les fonctions de date DAX retournent toujours un type de données datetime. Toutefois, vous pouvez si vous le souhaitez utiliser la mise en forme pour afficher des dates comme des numéros de série.
Cette fonction DAX peut retourner des résultats différents lorsqu'elle est utilisée dans un modèle déployé puis interrogé en mode DirectQuery. Pour plus d'informations sur les différences sémantiques en mode DirectQuery, consultez https://go.microsoft.com/fwlink/?LinkId=219171.
Exemple : retourner une date simple
Description
La formule suivante retourne la date du 8 juillet 2009 :
Code
=DATE(2009,7,8)
Exemple : années antérieures à 1899
Description
Si la valeur que vous entrez pour l'argument year est comprise entre 0 (zéro) et 1899 (inclus), cette valeur est ajoutée à 1900 pour calculer l'année. La formule suivante retourne le 2 janvier 1908 : (1900+08).
Code
=DATE(08,1,2)
Exemple : années antérieures à 1899
Description
Si la valeur que vous entrez pour l'argument year est comprise entre 0 (zéro) et 1899 (inclus), cette valeur est ajoutée à 1900 pour calculer l'année. La formule suivante retourne le 2 janvier 3700 : (1900+1800).
Code
=DATE(1800,1,2)
Exemple : années postérieures à 1899
Description
Si la valeur que vous entrez pour l'argument year est comprise entre 1900 et 9999 (inclus), cette valeur est utilisée comme année. La formule suivante retourne le 2 janvier 2008 :
Code
=DATE(2008,1,2)
Exemple : utilisation de mois
Description
Si le paramètre month est supérieur à 12, month ajoute ce nombre de mois au premier mois de l'année spécifiée. La formule suivante retourne la date du 2 février 2009 :
Code
=DATE(2008,14,2)
Commentaire
Si la valeur de month est inférieure à 1, la fonction DATE soustrait la grandeur de ce nombre de mois, plus 1, du premier mois de l'année spécifiée. La formule suivante retourne le 2 septembre 2007 :
=DATE(2008,-3,2)
Exemple : utilisation de jours
Description
Si la valeur de day est supérieure au nombre de jours du mois spécifié, day ajoute ce nombre de jours au premier jour du mois. La formule suivante retourne la date du 4 février 2008 :
Code
=DATE(2008,1,35)
Commentaire
Si day est inférieur à 1, day soustrait la grandeur de ce nombre de jours, plus un, du premier jour du mois spécifié. La formule suivante retourne le 16 décembre 2007 :
=DATE(2008,1,-15)