|
DIFF_DATE |
Date et heure |
FIRST_OF_PERIOD |
|
Fonction de script : Retourne la différence entre deux heures
DIFF_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 détermine la différence entre l'heure1 et l'heure2. 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 heure1 ou heure2 sans différence.
La fonction de script reçoit deux heures. L'indication d'un format d'heure est facultative. 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 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 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#
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