Hour (FPScript)
Détermine l'heure du jour d'une ou de plusieurs valeurs de temps calendaire ou période de temps.
Syntaxe
Hour(Time)
ou
Hour(Time, Timezone)
La syntaxe de la fonction Hour se compose des éléments suivants :
Section |
Description |
|---|---|
Time |
La valeur de temps calendaire ou de période de temps dont l'heure doit être extraite. Les structures de données autorisées sont Scalaire, Séries de données et Matrice de données. Tous les types de données réels sont autorisé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 |
Fuseau horaire pour lequel le résultat doit être déterminé, sous la forme d'un 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. Si vous avez spécifié une valeur d'intervalle de temps en tant qu'argument, alors le résultat sera déterminé en heure locale Time alors l'argument Timezone sera ignoré. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Entier de 16 bits, Entier de 32 bits, Entier de 64 bits, Virgule flottante de 32 bits, 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é. |
Remarques
Le type de données du résultat est toujours Virgule flottante de 64 bits.
La structure du résultat correspond à celle de l'argument Time, si nécessaire, le calcul est effectué élément par élément.
Le résultat a l'unité h.
Si l'argument ne représente pas un temps calendaire valide, alors une valeur à virgule flottante invalide (void) est renvoyée.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
Hour('2/9/04 12:30:00') |
Renvoie 12. |
Hour(-'12:30:00') |
Renvoie -12. |
Hour(1.25 d) |
Renvoie 6. Une valeur réelle avec une unité de temps est interprétée comme une période de temps. |
Hour(-300) |
Renvoie ?. Une valeur numérique sans unité est interprétée comme un temps calendaire. |