HOUR

Syntaxe

Paramètres

Description

Cette fonction permet de retourner l'heure d'une valeur de type date/heure, sous forme de nombre allant de 0 à 23.

Remarques

• Concept et objectif de HOUR : La fonction HOUR permet d'extraire la composante heure d'une valeur de type date/heure. Elle retourne un entier compris entre 0 et 23, représentant l'heure dans le format 24 heures. Cette fonction est utile pour segmenter les données horodatées, analyser des tendances horaires et calculer des métriques précises selon l'heure de la journée dans des rapports Power BI.
• Rôle du paramètre datetime : Le paramètre datetime désigne la valeur de type date/heure dont on souhaite extraire l'heure. Cette valeur peut provenir d'une colonne de type date/heure ou d'une expression DAX générant une date/heure. Il est essentiel que le type de donnée soit correct, car HOUR ne fonctionne pas sur des valeurs textuelles ou numériques non interprétées comme des dates.
• Format de retour : HOUR retourne toujours un nombre entier allant de 0 à 23, représentant l'heure du jour. Par exemple, pour la valeur «2025-12-23 14:37:52», la fonction retournera 14. Cette précision facilite les analyses temporelles et la création de graphiques ou tableaux segmentés par heure.
• Applications pratiques : Cette fonction est particulièrement utilisée pour analyser les données par tranche horaire, comme les ventes, le trafic sur un site web ou les événements horodatés. Elle peut être combinée avec des mesures de comptage ou de somme pour obtenir des statistiques par heure, identifier les pics d'activité ou optimiser les ressources selon les périodes de la journée.
• Combinaison avec d'autres fonctions temporelles : HOUR peut être associée à MINUTE, SECOND, NOW, TODAY ou TIME pour obtenir une granularité plus fine dans les analyses temporelles. Par exemple, elle peut servir à calculer des intervalles précis entre des événements ou créer des axes horaires détaillés dans les graphiques pour suivre l'évolution minute par minute ou heure par heure.
• Comportement avec les valeurs nulles ou incorrectes : Si le paramètre datetime contient une valeur nulle ou un type non compatible, HOUR retournera une erreur. Il est donc recommandé de filtrer les données ou de convertir les valeurs incorrectes avant d'utiliser cette fonction, afin d'assurer la robustesse des calculs dans les mesures ou colonnes calculées.
• Utilisation dans les mesures et colonnes calculées : HOUR peut être utilisée dans une colonne calculée pour entreposer l'heure correspondant à chaque ligne, ou dans une mesure pour extraire l'heure selon le contexte de filtre. Son utilisation dans les mesures permet de créer des rapports interactifs, par exemple en analysant les ventes par heure selon les filtres appliqués par l'utilisateur.
• Bonnes pratiques et performances : HOUR est une fonction simple et performante, même sur de grandes tables de données horodatées. Cependant, lorsqu'elle est utilisée de manière répétitive dans des modèles volumineux, il est conseillé d'utiliser des variables (VAR) pour stocker les résultats intermédiaires, ce qui améliore la lisibilité et la performance globale du modèle DAX. Documenter son usage dans les calculs horaires facilite également la maintenance.