SUB_***_TIME : soustraction d'une durée à une date
Traduction de la notice originale
A propos de nous
Description de la fonction
La fonction SUB_***_TIME enlève une durée d’une date ou d’une heure.
Les paramètres supplémentaires EN et ENO peuvent être configurés.
Fonctions disponibles
Les fonctions disponibles sont les suivantes :
Représentation en FBD
Représentation appliquée à une heure du jour :
Représentation en LD
Représentation appliquée à une heure du jour :
Représentation en IL
Représentation appliquée à une heure du jour : 
LD Source_Value
SUB_TOD_TIME Time_to_Sub
ST Result_Value
Représentation en ST
Représentation appliquée à une heure du jour : 
Result_Value := SUB_TOD_TIME(Source_Value, Time_to_Sub);
Description des paramètres
Le tableau suivant décrit les paramètres d’entrée :
Paramètre
Type
Commentaire
Source_Value
DT, TOD
Date ou heure.
Time_to_Sub
TIME
Durée à soustraire à Source_Value
Note : cette durée est exprimée au format TIME (avec une précision de l’ordre du dixième de secondes). Comme les types DT et TOD sont exprimés à la seconde près, Time_to_Sub est arrondie à la seconde.
Le tableau suivant décrit les paramètres de sortie :
Paramètre
Type
Commentaire
Result_Value
DT, TOD
Result_Value est de même type que Source_Value.
NOTE : la gestion des années bissextiles est à prévoir dans l’application.
Erreurs d’exécution
Pour le type TOD, il y a changement de jour si Result_Value est hors de l’intervalle des valeurs autorisées. Dans ce cas le bit système %S18 est positionné à 1 et la valeur de Result_Value n’est significative qu’avec un modulo 24:00:00.
Pour le type DT, si Result_Value est hors de l’intervalle des valeurs autorisées, le bit système %S18 est positionné à 1 et la valeur de Result_Value est égale à la borne minimale.
Si l’un des paramètres d’entrée n’est pas interprétable et cohérent au format de la fonction alors le bit système %S18 est positionné à 1 et Result_Value vaut :