|
SUB_PERIOD |
Date et heure |
SUB_TIMESTAMP |
|
Fonction de script : Soustrait deux heures
SUB_TIME(Time1, Time2, [Output Format])
|
Syntaxe |
Description / format |
|---|---|
|
heure1 |
Saisie d’une heure au format "HHMMSS". Format : littéral de script ou variable de script Il est possible d’indiquer l’heure dans un autre format d’heure. Pour cela, saisissez le format d’heure souhaité suivi d’un séparateur (;) puis l’heure. L’indication du format d’heure est facultative. |
|
Format de sortie |
Format prédéfini pour l'heure indiquée. |
|
Code retour |
|---|
|
Heure au format indiqué |
La fonction de script permet de soustraire deux heures. Elle prend en compte le passage de 23:59:59 à 00:00:00.
La fonction de script reçoit deux heures. L'indication d'un format d'heure est facultative. Si aucun format de l'heure spécifique n'est utilisé, l'heure doit être indiquée au format standard "HHMMSS". Seul le point-virgule peut être utilisé comme séparateur entre le format d'heure et l'heure.
Le format de sortie est facultatif. Si aucun format de sortie n'est utilisé, la fonction de script renvoie une heure au format "HHMMSS" par défaut.
Le premier exemple n'utilise pas de format d'heure. Le résultat ("110000") s'affiche dans le protocole d'activation.
:SET &TIME# = SUB_TIME("120000","010000")
:PRINT &TIME#
Le deuxième exemple utilise un format d'heure et un format de sortie. Le résultat est "23:00:00".
:SET &TIME# = SUB_TIME("040000", "HH;05", "HH:MM")
:PRINT &TIME#
Dans le troisième exemple, 31 secondes sont soustraites de 00:00:10. Un format d'heure est utilisé, mais il n'y a pas de format de sortie. Le résultat ("235940") correspond au format standard.
:SET &TIME# = SUB_TIME("HH:MM:SS;00:00:10", "SS;30")
:PRINT &TIME#
Semblable au troisième exemple. Mais le format de sortie est composé d'un paramètre spécial. Le résultat ("86380") est produit par la conversion de 23:59:40 en secondes.
:SET &TIME# = SUB_TIME("HHMMSS;000010", "SS;30", SS)
:PRINT &TIME#
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