TOD_TO_STRING : conversion d'une variable au format TOD en une chaîne de caractères

Description de la fonction

La fonction TOD_TO_STRING effectue la conversion d’une variable au format en une chaîne de caractères.

Les paramètres supplémentaires et peuvent être configurés.

Représentation en FBD

Représentation :

Représentation en LD

Représentation :

Représentation en IL

Représentation :

LD Time1

TOD_TO_STRING

ST Result_Str

Représentation en ST

Représentation :

Result_Str := =TOD_TO_STRING(Time1);

Description des paramètres

Le tableau suivant décrit les paramètres d’entrée :

Paramètre	Type	Commentaire
Time1	TOD	Heure du jour à convertir au format chaîne de caractères.

Le tableau suivant décrit les paramètres de sortie :

Paramètre	Type	Commentaire
Result_Str	STRING	Result_Str est une chaîne de 8 caractères qui contient une heure du jour au format suivant : HH:MM:SS. Exemple : ‘04:38:49’ Note : si la taille maximale de la chaîne Result_Str est supérieure à 8, Result_Str est complétée par des caractères de fin de chaîne (16#00).

Erreurs d’exécution

Si la chaîne Result_Str est trop courte pour contenir la valeur convertie (longueur inférieure à 8 caractères), celle-ci est tronquée et le bit %S15 est positionné à 1.

EN correspond à ENable (activer) ; il s'agit d'une entrée de bloc facultative. Quand l'entrée EN est activée, une sortie ENO est automatiquement définie.

Si EN = 0, le bloc n'est pas activé, son programme interne n'est pas exécuté et ENO est réglé sur 0.

Si EN = 1, le programme interne du bloc est exécuté et ENO est réglé sur 1. Si une erreur survient, ENO reprend la valeur 0.

Si l'entrée EN n'est pas connectée, elle est automatiquement réglée sur 1.

ENO

ENO signifie Error NOtification (notification d'erreur). C'est la sortie associée à l'entrée facultative EN.

Si ENO est réglé sur 0 (car EN = 0 ou en cas d'erreur d'exécution) :

les sorties du bloc fonction restent dans l'état qui était le leur lors du dernier cycle de scrutation exécuté correctement ;
la ou les sorties de la fonction, ainsi que les procédures, sont réglées sur 0.

TOD

TOD est l'abréviation de Time Of Day (heure de la journée).

Le type TOD, codé en BCD dans un format 32 bits, contient les informations suivantes :

l'heure codée dans un champ de 8 bits ;
les minutes codées dans un champ de 8 bits ;
les secondes codées dans un champ de 8 bits.

NOTE : les 8 bits de poids faible ne sont pas utilisés.

Le type TOD doit être saisi comme suit : TOD#<Heure>:<Minutes>:<Secondes>

Le tableau ci-après donne les limites inférieure/supérieure de chaque élément :

Champ	Limites	Commentaire
Heure	[00,23]	Le 0 initial est toujours affiché ; il peut être omis lors de la saisie.
Minute	[00,59]	Le 0 initial est toujours affiché ; il peut être omis lors de la saisie.
Seconde	[00,59]	Le 0 initial est toujours affiché ; il peut être omis lors de la saisie.

Exemple : TOD#23:59:45.