TEMPS

Convertit les heures, minutes et secondes données sous forme de nombres en heure au format DateHeure.

Syntaxe

TIME(hour, minute, second)  

Paramètres

Terme Définition
hour Mode Importation : nombre compris entre 0 et 32767, représentant les heures.
Toute valeur supérieure à 23 est divisée par 24. Le reste constitue la valeur d’heure, représentée sous la forme d’une fraction d’un jour.
Par exemple, TIME(27,0,0) = TIME(3,0,0) = 3:00:00 AM

Mode DirectQuery : nombre compris entre 0 et 23, représentant les heures.
minute Mode Importation : nombre compris entre 0 et 32767, représentant les minutes.
Toute valeur supérieure à 59 minutes est convertie en heures et en minutes.
Toute valeur supérieure à 1440 (24 heures) ne modifie pas la partie de la date. À la place, elle est divisée par 1440 et le reste est traité comme la valeur de la minute, représentée sous la forme d’une fraction d’un jour.
Par exemple, TIME(0,2190,0) = TIME(0,750,0) = TIME(12,30,0) = 12:30:00 PM

Mode DirectQuery : nombre compris entre 0 et 59, représentant les minutes.
second Mode Importation : nombre compris entre 0 et 32767, représentant les secondes.
Toute valeur supérieure à 59 est convertie en heures, minutes et secondes.
Par exemple, TIME(0,0,2000) = TIME(0,33,20) = 12:33:20 AM

Mode DirectQuery : nombre compris entre 0 et 59, représentant les secondes.

Valeur retournée

Une heure (datetime) comprise entre 00:00:00 (12:00:00 AM) et 23:59:59 (11:59:59 PM).

Remarques

  • Contrairement à Microsoft Excel qui stocke les dates et les heures sous la forme de numéros de série, DAX utilise les valeurs de date et d’heure au format DateHeure. Les nombres dans d’autres formats sont implicitement convertis quand vous utilisez une valeur de date/heure dans une fonction DAX. Si vous avez besoin d’utiliser des numéros de série, vous pouvez utiliser la mise en forme pour changer la façon dont les nombres sont affichés.

  • Les valeurs d’heure font partie d’une valeur de date et sont représentées par un nombre décimal dans le système de numéros de série. Ainsi, la valeur DateHeure 12:00 PM équivaut à 0,5 car elle correspond à la moitié de la journée.

  • Vous pouvez fournir les arguments à la fonction TIME de plusieurs manières : en tapant directement des valeurs, en spécifiant le résultat d’une autre expression ou en faisant référence à une colonne qui contient une valeur numérique.

  • Les valeurs Date et DateHeure peuvent également être spécifiées en tant que littéral au format dt"YYYY-MM-DD", dt"YYYY-MM-DDThh:mm:ss" ou dt"YYYY-MM-DD hh:mm:ss". Quand elle est spécifiée en tant que littéral, il n’est pas nécessaire d’utiliser la fonction TIME dans l’expression. Pour en savoir plus, consultez Syntaxe DAX | Date et heure.

  • Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery quand elle est utilisée dans des colonnes calculées ou des règles de sécurité au niveau des lignes (RLS).

Exemple 1

Les exemples suivants retournent tous les deux l’heure, 3:00 AM :

= TIME(27,0,0)
= TIME(3,0,0)  

Exemple 2

Les exemples suivants retournent tous les deux l’heure, 12:30 PM :

= TIME(0,750,0)
= TIME(12,30,0)  

Exemple 3

L’exemple suivant crée une heure basée sur les valeurs des colonnes intHours, intMinutes et intSeconds :

= TIME([intHours],[intMinutes],[intSeconds])  

DATE
Fonctions de date et heure