DIFF_TIME

Fonction de script : Retourne la différence entre deux heures

DIFF_TIME ([Time Format;]Time1, [Time Format;]Time2 [,Output Format])

Syntaxe	Description / format
Time1 et Time2	Time in HHMMSS format Format: script literal or script variable (Optional) You can specify a different time format: enter the desired time format, a separator (: or ;) and the time.
Output Format	Format de sortie prédéfini pour l'heure indiquée. Format : nom AE, littéral de script ou variable de script Défaut : "HHMMSS"

Code retour
Heure au format indiqué

La fonction de script détermine la différence entre les heures Time1 et Time2. La différence de temps est toujours calculée entre l'heure actuelle au plus tôt et au plus tard. Par conséquent, l'heure au plus tard peut être saisie dans Time1 ou Time2 sans différence.

La fonction de script reçoit deux heures. L'indication d'un format d'heure est optionnelle. Si aucun format d'heure n'a été défini, l'heure doit être indiquée au format standard "HHMMSS". Seul le point-virgule peut être utilisé comme séparateur entre le format de l'heure et l'heure. Si des paramètres spéciaux sont utilisés avec le format de l'heure, le calcul est réalisé avec le nombre d'heures, de minutes ou de secondes indiqué. Les informations manquantes sont systématiquement remplacées par "00". 

Le format de sortie est optionnel. Si aucun format de sortie n'est utilisé, la fonction de script renvoie une heure au format "HHMMSS" par défaut.

Exemples

Le premier exemple détermine la différence entre les heures. Les heures utilisent le format par défaut "HHMMSS". Le résultat "003000" est affiché dans le rapport.

:SET &DIFF# = DIFF_TIME("230000", "223000")
:PRINT &DIFF#

Dans cet exemple, un paramètre spécial est utilisé pour la deuxième heure. Ainsi, les heures et secondes correspondantes sont automatiquement "00". Un format de sortie est prédéfini. Le résultat "00:09" apparaît dans le rapport.

:SET &DIFF# = DIFF_TIME("HH:MM:SS;00:01:30", "MM;11", "HH:MM")
:PRINT &DIFF#

Dans le troisième exemple, les heures saisies sont attribuées aux variables de script. La fonction de script est appelée avec ces variables de script. Comme les heures n'utilisent pas le format par défaut, le format d'heure spécial doit également être indiqué pour les variables de script. Le résultat "120000" est affiché dans le rapport.

:SET &TIME1# = "00:00:00"
:SET &TIME2# = "12:00:00"
:SET &DIFF# = DIFF_TIME("HH:MM:SS;&TIME1#", "HH:MM:SS;&TIME2#")
:PRINT &DIFF# 

Voir aussi :