SYS_TIME

Date et heure

SYS_TIMESTAMP_PHYSICAL

---

SYS_TIME_PHYSICAL

Fonction de script : Définit l'heure actuelle du jour.

Syntaxe

SYS_TIME_PHYSICAL([Format d'heure], [Fuseau horaire])

Remarques

La fonction de script détermine l'heure actuelle du jour. Un fuseau horaire indiqué dans un paramètre est pris en compte dans le calcul.

Remarque : Si la fonction de script est utilisée plusieurs fois dans un script, des résultats différents peuvent être obtenus (par exemple, en cas de demande précise de secondes ou de minutes). La fonction de script est donc différente de SYS_TIME, qui détermine l'heure u début du traitement du script, puis la "gèle" pour garantir la cohérence du script. 

Le format d'heure est facultatif. Il sert à déterminer le format dans lequel la fonction doit renvoyer sa valeur. Si vous n'avez pas indiqué de format d'heure, le format par défaut "HHMMSS" est utilisé.

Le fuseau horaire est également facultatif. Si la fonction de script est exécutée sans ce paramètre, le fuseau horaire de l'objet est utilisé ou celui du client si aucun fuseau horaire n'a été défini pour l'objet lui-même. Si un fuseau horaire non défini a été indiqué, le calcul se fait automatiquement avec la valeur par défaut (fuseau horaire du client). Au lieu d'un fuseau horaire, vous pouvez également utiliser le mot clé UTC. L'heure est renvoyée directement en UTC (temps universel coordonné).

Exemples

Le premier exemple détermine l'heure actuelle du jour et transmet la valeur à la variable de script. Le résultat correspond à deux heures séparées par 10 secondes au moins.

:SET &TIME1# = SYS_TIME_PHYSICAL("HH:MM:SS")
:WAIT 10
:SET &TIME2# = SYS_TIME_PHYSICAL("HH:MM:SS")

Dans le deuxième exemple, l'heure actuelle du jour est déterminée en UTC. Lors de la deuxième exécution de la fonction de script, un fuseau horaire défini pour l'heure d'Europe centrale est indiqué. Le résultat correspond à deux heures séparées par 1 heure et 10 secondes au moins.

:SET &TIME1# = SYS_TIME_PHYSICAL("HH:MM:SS","UTC")
:WAIT 10
:SET &TIME2# = SYS_TIME_PHYSICAL("HH:MM:SS","TZ.MEZ")

Dans le troisième exemple, un paramètre spécial est utilisé et transmis par une variable de script. Seules les minutes de l'heure actuelle du jour sont déterminées

:SET &FORMAT# = "MM"
:SET &TIME# = SYS_TIME_PHYSICAL(&FORMAT#)

Si la fonction est utilisée sans indiquer de format d'heure, la syntaxe se présente comme dans l'exemple suivant.

:IF SYS_TIME_PHYSICAL() = "120000"  
!...
:ENDIF

Rubriques connexes :

Eléments de script - Date et heure

Formats de date, d'heure et de période

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle