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

Description de la fonction

La fonction TIME_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

TIME_TO_STRING

ST Result_Str

Représentation en ST

Représentation :

Result_Str := TIME_TO_STRING(Time1);

Description des paramètres

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

Paramètre	Type	Commentaire
Time1	TIME	Durée à 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 15 caractères qui contient une durée au format suivant : HHHHHH:MM:SS.D. Exemple : ‘119304:38:49.5’ Note : si la taille maximale de la chaîne Result_Str est supérieure à 15, 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 à 15 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.

TIME

Le type TIME exprime une durée en millisecondes. Codé sur 32 bits, ce type permet d'obtenir des durées de 0 à 2 32-1 millisecondes.

Le type TIME présente les unités suivantes : jours (d), heures (h), minutes (m), secondes (s) et millisecondes (ms). Une valeur littérale de type TIME est représentée par une combinaison des types précédents associés au préfixe T#, t#, TIME# ou time#.

Exemples : T#25h15m, t#14,7S, TIME#5d10h23m45s3ms