|
ADD_PERIOD |
Date et heure |
ADD_TIMESTAMP |
|
Fonction de script : Ajoute une heure à une autre
ADD_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 pour l'heure déterminée. |
|
Code retour |
|---|
|
Heure au format indiqué |
La fonction de script vous permet d'ajouter 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 spécifique est alors facultative. Si aucun format d'heure 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 ("130000") s'affiche dans le protocole d'activation.
:SET &TIME# = ADD_TIME("120000","010000")
:PRINT &TIME#
Le deuxième exemple utilise un format d'heure et un format de sortie. Le résultat est "04:59".
:SET &TIME# = ADD_TIME("235959", "HH;05", "HH:MM")
:PRINT &TIME#
Dans le troisième exemple, 71 secondes sont ajoutées à 23:59:59. Un format d'heure est utilisé, mais il n'y a pas de format de sortie. Le résultat ("000110") correspond au format standard.
:SET &TIME# = ADD_TIME("HH:MM:SS;23:59:59", "SS;71")
:PRINT &TIME#
L'exemple suivant est semblable au troisième exemple. Mais le format de sortie est composé d'un paramètre spécial. Le résultat ("70") s'affiche en secondes dans le protocole d'activation.
:SET &TIME# = ADD_TIME("HHMMSS;235959", "SS;71", 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