ARINT_TO_DT: Conversion d'un tableau d'entiers avec date et heure en une variable DT

Description de la fonction

La fonction convertit un tableau d'entiers avec la date et l'heure au format en une variable (dt#).

Vous avez deux options pour l'entrée :

Pour affecter l'heure système, attribuez %SW50 à l'entrée.

Dans ce cas, le contenu de %SW50 et de %SW53 est affecté.
Pour affecter une autre heure, créez un tableau d'entiers à quatre éléments et entrez l'heure et la date au format BCD.

Exemple :

Si l'entrée est :

DateAndTime_ARRAY[1] = 16#1600
DateAndTime_ARRAY[2] = 16#1046
DateAndTime_ARRAY[3] = 16#0511
DateAndTime_ARRAY[4] = 16#2006

Alors la sortie est :

DT_Variable = dt#2006-05-11-10:46:16

et peuvent être configurés en tant que paramètres supplémentaires.

Représentation en FBD

Représentation en LD

Représentation en IL

LD DateAndTime_ARRAY ARINT_TO_DT ST DT_Variable

Représentation en ST

DT_Variable := ARINT_TO_DT (DateAndTime_ARRAY) ;

Description des paramètres

Description des paramètres d'entrée :

Paramètres	Type de données	Signification
DateAndTime_ARRAY	ARRAY [n..m] OF INT	Entier ARRAY de quatre éléments avec la date et l'heure au format BCD : secondes,-- (16#ss,--), correspond à %SW50 heure, minutes (16#hhmm), correspond à %SW51 mois, jour (16#mmjj), correspond à %SW52 année (16#aaaa), correspond à %SW53

Description des paramètres de sortie :

Paramètres	Type de données	Signification
DT_Variable	DT	Date et heure affectées à l'entrée en tant que variable DATE_AND_TIME (dt#) (si l'entrée est valide).

Erreurs d'exécution

Si l'entrée DateAndTime_ARRAY est incorrecte, ENO = 0 et OUT reste inchangé.

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.

BCD

BCD est l'acronyme du format Binary Coded Decimal (décimal codé en binaire).

Le format BCD permet de représenter des nombres décimaux compris entre 0 et 9 à l'aide d'un groupe de quatre bits (un demi-octet).

Dans ce format, les quatre bits employés pour coder les nombres décimaux ont une plage de combinaisons inutilisée.

Exemple de codage BCD :

Le nombre 2 450
est codé 0010 0100 0101 0000.

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.