Date

Syntaxe

Paramètres

Description

Cette fonction permet de créer une valeur de date à partir de composants individuels (année, mois, jour).

Remarques

• La fonction Date est essentielle pour créer une valeur de date à partir de trois composants distincts : année, mois et jour. Elle est idéale pour construire des dates dynamiquement à partir d'entrées utilisateur ou de calculs. Cela permet de générer des dates précises dans des flux de travaux, des rapports ou des filtres.
• Le paramètre Year permet de spécifier l'année, ce qui est utile notamment dans des calculs sur plusieurs années, comme des échéances, des anniversaires ou des comparaisons d'historique. Il peut être un nombre fixe ou une variable calculée selon le contexte. C'est un élément fondamental pour manipuler les données temporelles.
• Le paramètre Month accepte des valeurs de 1 à 12, mais Power Fx gère aussi intelligemment les débordements. Par exemple, Date(2024, 13, 10) renverra automatiquement le 10 janvier 2025. Cela permet une certaine souplesse dans les calculs de mois sans provoquer d'erreur.
• Le paramètre Day fonctionne de manière similaire et permet de dépasser la longueur du mois. Ainsi, Date(2023, 2, 30) retournera le 2 mars 2023, car février 2023 a 28 jours. Cette gestion automatique évite d'avoir à coder des vérifications complexes sur la validité des dates.
• La fonction Date retourne une valeur de type date seule, sans heure ni fuseau horaire. Elle est donc idéale pour des scénarios où seule la date est pertinente, comme des calendriers ou des historiques journaliers. Cela évite les erreurs liées aux heures implicites ou aux décalages horaires.
• En combinaison avec d'autres fonctions comme Time, Now, ou DateAdd, la fonction Date permet de manipuler précisément le temps. Elle peut être utilisée comme base pour générer des horodatages personnalisés ou calculer des différences entre dates. C'est une brique centrale dans les traitements temporels.
• Lorsqu'elle est utilisée avec des contrôles utilisateur (exemple : Dropdown, TextInput), la fonction Date permet de créer une valeur complète à partir d'éléments indépendants. Cela est particulièrement utile dans des formulaires ou des générateurs de dates personnalisés. Elle contribue ainsi à une expérience utilisateur plus interactive et contrôlée.
• Enfin, Date est compatible avec la plupart des fonctions de comparaison et de tri, ce qui en fait un choix judicieux pour structurer des tableaux chronologiques. Elle facilite la mise en oeuvre de filtres, de regroupements ou d'analyses par période. C'est une fonction simple mais puissante pour toute logique basée sur le temps.