ADD_***_TIME : ajout d'une durée à une date
Traduction de la notice originale
A propos de nous
Description de la fonction
La fonction ADD_***_TIME ajoute une durée à une date ou à 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
ADD_TOD_TIME Time_to_Add
ST Result_Value
Représentation en ST
Représentation appliquée à une heure du jour : 
Result_Value := ADD_TOD_TIME(Source_Value, Time_to_Add);
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_Add
TIME
Durée à ajouter à Source_Value
Note : ce temps est exprimé au format TIME donc 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_Add 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 et à prévoir dans l’application.
Erreurs d’exécution
Pour le type TOD, il y a changement de jour si Result_Value est hors 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 maximale.
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 :