DateTime |
Date et heure |
|---|---|
| Power Fx | |
Syntaxe
| DateTime( Year, Month, Day, Hour, Minute, Second [, Milliseconds ] ) |
Paramètres
| Nom | Description |
|---|---|
| Year | Ce paramètre représente l'année de la date et heure à créer. Ce paramètre permet de définir l'élément annuel de la valeur de date et heure. |
| Month | Ce paramètre représente le mois (de 1 à 12). Ce paramètre permet de définir l'élément mensuel de la valeur de date et heure. |
| Day | Ce paramètre représente le jour du mois. Ce paramètre permet de définir l'élément journalier de la valeur de date et heure. |
| Hour | Ce paramètre représente l'heure (de 0 à 23). Ce paramètre permet de définir l'élément horaire de la valeur de date et heure. |
| Minute | Ce paramètre représente les minutes (de 0 à 59). Ce paramètre permet de définir l'élément minute de la valeur de date et heure. |
| Second | Ce paramètre représente les secondes (de 0 à 59). Ce paramètre permet de définir l'élément seconde de la valeur de date et heure. |
| Milliseconds | Ce paramètre représente les millisecondes (de 0 à 999). Ce paramètre permet de définir l'élément millisecondes de la valeur de date et heure. |
Description
Cette fonction permet de retourner la date et l'heure actuelles.
Remarques
- La fonction DateTime permet de construire une valeur précise de type date/heure à partir de composants individuels comme l'année, le mois, le jour, l'heure, les minutes, les secondes et même les millisecondes. C'est une fonction utile pour générer des horodatages exacts dans des scénarios où la précision est primordiale. Elle est particulièrement pertinente dans les systèmes de journalisation, de planification ou de suivi d'événements.
- Le paramètre Year permet de définir la composante annuelle de la date/heure. Ce champ est indispensable pour situer l'événement dans le bon contexte chronologique, que ce soit dans le passé ou le futur. Sa précision est essentielle pour tout calcul ou affichage basé sur l'historique.
- Avec le paramètre Month, on peut spécifier le mois exact, entre 1 (janvier) et 12 (décembre). Cela permet de gérer des événements récurrents, des bilans mensuels ou encore des programmations planifiées à long terme. Attention toutefois aux erreurs de validité (par exemple, le 30 février est invalide).
- Le paramètre Day complète la construction de la date en déterminant le jour du mois. Associé aux autres paramètres temporels, il permet de définir une date complète utile dans des contextes métiers exigeants. Son usage implique parfois une vérification préalable pour éviter les dates invalides selon le mois et l'année.
- Les paramètres Hour, Minute et Second permettent d'aller au-delà de la simple date pour gérer des événements horodatés dans la journée. Ils sont essentiels pour tout système qui repose sur des intervalles courts comme les agendas, les capteurs, ou la gestion de présence. La granularité temporelle offerte est idéale pour les besoins en temps réel.
- Le paramètre Milliseconds ajoute une précision extrême à la valeur générée, bien qu'il soit rarement utilisé dans les applications courantes. Cependant, pour les cas où les données doivent être triées ou comparées avec une précision très fine (exemple : enregistrements de transactions rapides), ce champ devient crucial. Cela montre que Power Fx est capable de gérer des scénarios complexes.
- Contrairement à la fonction Now() qui retourne l'instant actuel automatiquement, DateTime permet de créer manuellement une date/heure précise. Cela est utile lorsque l'on veut générer des dates artificielles pour des tests, des simulations, ou des saisies personnalisées dans une application. Cette souplesse renforce le contrôle sur la gestion temporelle dans Power Apps.
- Utiliser DateTime en conjonction avec d'autres fonctions comme DateAdd, DateDiff, ou Text permet de manipuler, formater ou comparer des horodatages efficacement. C'est une brique fondamentale pour toute logique métier liée au temps. Elle permet aussi de combiner facilement des éléments fournis par l'utilisateur (champs de formulaire) pour créer une valeur cohérente de type date/heure.
Dernière mise à jour : Jeudi, le 1 Mai 2025