DATE
s’applique à :
colonne calculéetable calculéemesurecalcul 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 un à quatre chiffres. L’argument year est interprété en fonction du système de date utilisé par votre ordinateur.Les dates commençant par le 1er mars 1900 sont prises en charge. Si vous entrez un nombre qui a des décimales, le nombre 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 year est comprise entre 0 et 1899, la valeur est ajoutée à 1900 pour produire la valeur finale. Consultez les exemples ci-dessous.
Remarque : Vous devez utiliser quatre chiffres pour l’argument year dans la mesure du possible pour empêcher les résultats indésirables. Par exemple, l’utilisation de 07 retourne 1907 comme valeur d’année. |
month |
Nombre représentant le mois ou un calcul en fonction des règles suivantes : Les entiers négatifs ne sont pas pris en charge. Les valeurs valides sont 1 à 12. 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’au 12 décembre.Si vous entrez un entier supérieur à 12, le calcul suivant se produit : la date est calculée en ajoutant la valeur de month au year. Par exemple, si vous avez DATE(2008, 18, 1), la fonction retourne une valeur datetime équivalente au 1er juin 2009, car 18 mois sont ajoutés au début de 2008, ce qui donne une valeur de juin 2009. Consultez les exemples ci-dessous. |
day |
Nombre représentant le jour ou un calcul en fonction des règles suivantes : Les entiers négatifs ne sont pas pris en charge. Les valeurs valides sont 1 à 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 se produit : 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 donne une valeur du 1er avril.Si day contient une partie décimale, elle est arrondie à la valeur entière la plus proche. |
Valeur de retour
Retourne la date spécifiée (datetime).
Remarques
La fonction DATE prend les entiers qui sont des arguments d’entrée et génère la date correspondante. La fonction DATE est la plus 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, telle que AAAAMMDD. Vous pouvez utiliser la fonction DATE conjointement avec d’autres fonctions pour convertir les dates en un nombre qui peut être reconnu comme une date.
Contrairement à Microsoft Excel, qui stocke les dates sous la forme d’un numéro de série, DAX fonctions de date retournent toujours un type de données
datetime. Toutefois, vous pouvez utiliser la mise en forme pour afficher les dates en tant que numéros de série si vous le souhaitez.Date et datetime peuvent également être spécifiés en tant que littéral au format
dt"YYYY-MM-DD",dt"YYYY-MM-DDThh:mm:ss"oudt"YYYY-MM-DD hh:mm:ss". Lorsqu’elle est spécifiée en tant que littéral, l’utilisation de la fonction DATE dans l’expression n’est pas nécessaire. Pour plus d’informations, consultez DAX syntaxe | Date et heure.Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).
Exemples
Simple Date
La formule suivante retourne la date du 8 juillet 2009 :
= DATE(2009,7,8)
Années antérieures à 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 year est comprise entre 1900 et 9999 (inclus), cette valeur est utilisée comme année. La formule suivante retourne le 2 janvier 2008 :
= DATE(2008,1,2)
Mois
Si 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 :
= DATE(2008,14,2)
Jours
Si day est supérieur 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)