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

Description de la fonction

La fonction DT_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 Date1

DT_TO_STRING

ST Result_Str

Représentation en ST

Représentation :

Result_Str := DT_TO_STRING(Date1);

Description des paramètres

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

Paramètre	Type	Commentaire
Date1	DT	Date à 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 19 caractères qui contient une date (avec les heures) au format suivant : YYYY-MM-DD-HH:MM. Exemple : ‘2000-12-27-23:15’ Note : si la taille maximale de la chaîne Result_Str est supérieure à 19, 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 date (longueur inférieure à 19 caractères), la date est tronquée et le bit %S15 est positionné à 1.

Si Date1 n’est pas interprétable et cohérent en format DT, le bit système %S18 est positionné à 1 et Result_Str =’****-**-**-**:**:**’.

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.

DT est l'acronyme de « Date and Time » (date et heure).

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

l'année codée dans un champ de 16 bits ;
le mois codé dans un champ de 8 bits ;
le jour codé dans un champ de 8 bits ;
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 DT doit être saisi comme suit :

DT#<Année>-<Mois>-<Jour>-<Heure>:<Minutes>:<Secondes>

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

Champ	Limites	Commentaire
Année	[1990,2099]	Année
Mois	[01,12]	Le 0 initial est toujours affiché ; il peut être omis lors de la saisie.
Jour	[01,31]	Pour les mois 01/03/05/07/08/10/12
	[01,30]	Pour les mois 04/06/09/11
	[01,29]	Pour le mois 02 (années bissextiles)
	[01,28]	Pour le mois 02 (années non bissextiles)
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.