DATE
S’applique à :
Colonne calculéeTable calculéeMesureCalcul de visuel
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 d’un à quatre chiffres. L’argument year est interprété en fonction du système de date utilisé par votre ordinateur. Les dates à partir du 1er mars 1900 sont prises en charge. Si vous entrez un nombre comportant des décimales, il est arrondi. Pour les valeurs supérieures à 9 999 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 générer la valeur finale. Considérons les exemples ci-dessous. Remarque : Vous devez utiliser quatre chiffres pour l’argument year chaque fois que possible pour éviter des résultats indésirables. Par exemple, l’utilisation de 07 retourne 1907 comme valeur de year. |
| month | Nombre représentant le mois ou un calcul conforme aux règles suivantes : Les entiers négatifs ne sont pas pris en charge. Les valeurs valides sont comprises entre 1 et 12. Si month est un nombre compris entre 1 et 12, il représente un mois de l’année. 1 représente le mois de janvier, 2 le mois de février, et ainsi de suite jusqu’à 12 qui représente le mois de 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 à year. Par exemple, la formule DATE( 2008, 18, 1) retourne une valeur datetime équivalente au 1er juin 2009, car 18 mois sont ajoutés au début de 2008, ce qui équivaut à juin 2009. Voir les exemples ci-dessous. |
| day | Nombre représentant le jour ou un calcul conforme aux règles suivantes : Les entiers négatifs ne sont pas pris en charge. Les valeurs valides sont comprises entre 1 et 31. 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 à month. Par exemple, dans la formule DATE( 2008, 3, 32), la fonction DATE retourne une valeur datetime équivalente au 1er avril 2008, car 32 jours sont ajoutés au début du mois de mars, ce qui équivaut au 1er avril.Si day contient une partie décimale, la valeur est arrondie à l’entier le plus proche. |
Valeur renvoyée
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 particulièrement 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 conjointement à d’autres fonctions pour convertir les dates en un nombre pouvant être reconnu comme une date.
Contrairement à Microsoft Excel, qui stocke les dates en tant que nombres ordinaux, les fonctions de date DAX retournent toujours un type de données datetime. Toutefois, vous pouvez utiliser la mise en forme pour afficher les dates en tant que nombres ordinaux si vous le souhaitez.
Les valeurs Date et DateHeure peuvent également être spécifiées en tant que littéral au format
dt"YYYY-MM-DD",dt"YYYY-MM-DDThh:mm:ss"oudt"YYYY-MM-DD hh:mm:ss". Quand elle est spécifiée en tant que littéral, il n’est pas nécessaire d’utiliser la fonction DATE dans l’expression. Pour en savoir plus, consultez Syntaxe DAX | Date et heure.Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery quand elle est utilisée dans des colonnes calculées ou des règles de sécurité au niveau des lignes (RLS).
Exemples
Date simple
La formule suivante retourne la date du 8 juillet 2009 :
= DATE(2009,7,8)
Années avant 1899
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).
= DATE(08,1,2)
Années après 1899
Si la valeur year est comprise entre 1900 et 9999 (inclus), elle est utilisée comme année. La formule suivante retourne le 2 janvier 2008 :
= DATE(2008,1,2)
Mois
Si la valeur month est supérieure à 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 :
= DATE(2008,14,2)
Jours
Si la valeur 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 :
= DATE(2008,1,35)