Détermine le temps d'une ou plusieurs valeurs de temps calendaire comme valeur de période de temps ou génère une valeur de période de temps basée sur les éléments spécifiés.
Syntaxe
Time(CalendarTime)
ou
Time(CalendarTime, le Timezone)
ou
Time(Hours, le Minutes, le Seconds)
ou
Time(Days, le Hours, le Minutes, le Seconds)
La syntaxe de la fonction Time se compose des éléments suivants :
Section |
Description |
|---|---|
CalendarTime |
La valeur de temps calendaire à partir de laquelle le temps doit être extrait. Si l'argument ne représente pas une valeur de temps calendaire valide, alors une valeur à virgule flottante invalide est renvoyée. Les structures de données autorisées sont Scalaire, le Série de données et Matrice de données. Tous les types de données réels sont autorisés, sauf Période de temps. L'argument est transformé dans l'unité s. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
Timezone |
Correspond au fuseau horaire pour lequel le résultat doit être déterminé, sous forme de décalage horaire par rapport au temps universel coordonné (UTC), en heures. Si vous omettez l'argument, le résultat sera déterminé en heure locale. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Entier de 16 bits, le Entier de 32 bits, le Entier de 64 bits, le Virgule flottante de 32 bits, le Virgule flottante de 64 bits et Période de temps. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Days |
Le nombre de jours dans l'intervalle de temps. Les structures de données autorisées sont Scalaire et Série de données. Tous les types de données réels sont autorisés. L'argument est transformé dans l'unité d. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Hours |
Le nombre d'heures dans l'intervalle de temps. Les structures de données autorisées sont Scalaire et Série de données. Tous les types de données réels sont autorisés. L'argument est transformé dans l'unité h. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Minutes |
Le nombre de minutes dans l'intervalle de temps. Les structures de données autorisées sont Scalaire et Série de données. Tous les types de données réels sont autorisés. L'argument est transformé dans l'unité min. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Seconds |
Le nombre de secondes dans l'intervalle de temps. Les structures de données autorisées sont Scalaire et Série de données. Tous les types de données réels sont autorisés. L'argument est transformé dans l'unité s. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Remarques
Le type de données du résultat est toujours Période de temps.
La structure du résultat correspond à celle de l'argument CalendarTime, si nécessaire, le calcul est effectué élément par élément.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
Time('2.3.04 12:13:14') |
Renvoie '12:13:14'. |
Time(CurrentDate(), 0) |
Renvoie l'heure actuelle en Temps universel coordonné. |
Time(12, 30, 45.6) |
Renvoie '12:30:45.6'. |
Time(12, -30, 45.6) |
Renvoie '11:30:45.6'. |
-Time(12, 30, 45.6) |
Renvoie -'12:30:45.6'. |
Time(-12, -30, -45.6) |
Renvoie -'12:30:45.6'. |
Time(3, 12, 30, 45.6) |
Renvoie '3:12:30:45.6'. |
Time(3 d, 12 h, 30 min, 45 ms) |
Renvoie '3:12:30:00.045'. |