Fonction TIME (DAX)
Convertit les heures, minutes et secondes données comme nombres en une heure au format datetime.
Syntaxe
TIME(hour, minute, second)
Paramètres
Terme |
Définition |
|---|---|
hour |
Nombre compris entre 0 et 23 représentant l'heure. Toute valeur supérieure à 23 sera divisée par 24 et le reste sera traité comme valeur d'heure. |
minute |
Nombre compris entre 0 et 59 représentant la minute. Toute valeur supérieure à 59 sera convertie en heures et minutes. |
second |
Nombre compris entre 0 et 59 représentant la seconde. Toute valeur supérieure à 59 sera convertie en heures, minutes et secondes. |
Valeur de retour
Heure (datetime).
Notes
Contrairement à Microsoft Excel, qui stocke les dates et heures comme des numéros de série, DAX utilise les valeurs de date et d'heure sous un format datetime. Les nombres sous d'autres formats sont convertis implicitement lorsque vous utilisez une valeur de date/d'heure dans une fonction DAX. Si vous devez utiliser des numéros de série, vous pouvez utiliser la mise en forme pour modifier la façon dont les nombres sont affichés.
Les valeurs d'heure sont une partie d'une valeur de date et sont représentées par un nombre décimal dans le système des numéros de série. Par conséquent, la valeur datetime 12:00 est équivalente à 0,5, car il s'agit de la moitié d'un jour.
Vous pouvez fournir les arguments à la fonction TIME comme valeurs que vous tapez directement, comme résultat d'une autre expression ou par une référence à une colonne qui contient une valeur numérique. Les restrictions suivantes s'appliquent :
Toute valeur pour hours qui est supérieure à 23 sera divisée par 24 et le reste sera traité comme valeur d'heure.
Toute valeur pour minute qui est supérieure à 59 sera convertie en heures et minutes.
Toute valeur pour second qui est supérieure à 59 sera convertie en heures, minutes et secondes.
Pour les minutes ou les secondes, une valeur supérieure à 24 heures sera divisée par 24 et le reste sera traité comme valeur d'heure. Une valeur en excès de 24 heures ne modifie pas la partie de date.
Pour améliorer la lisibilité des valeurs d'heure retournées par cette fonction, nous vous recommandons de mettre en forme la colonne ou cellule de tableau croisé dynamique qui contient les résultats de la formule à l'aide de l'un des formats d'heure proposés par Microsoft Excel.
Exemple
Les exemples suivants retournent tous deux l'heure 3:00 :
=TIME(27,0,0)
=TIME(3,0,0)
Les exemples suivants retournent tous deux l'heure 12:30 :
=TIME(0,750,0)
=TIME(12,30,0)
L'exemple suivant crée une heure selon les valeurs dans les colonnes intHours, intMinutes, intSeconds :
=TIME([intHours],[intMinutes],[intSeconds])