DT_TO_ARINT: Conversion d'une variable DT en tableau d'entiers

Description de la fonction

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

Exemple :

Si l'entrée est :

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

Alors la sortie est :

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

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 DT_Variable DT_TO_ARINT ST DateAndTime_ARRAY

Représentation en ST

DateAndTime_ARRAY := DT_TO_ARINT (DT_Variable) ;

Description des paramètres

Description des paramètres d'entrée :

Paramètres	Type de données	Signification
DT_Variable	DT	Date et heure en tant que variable DATE_AND_TIME (dt#).

Description des paramètres de sortie :

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

Erreurs d'exécution

Si la taille de la sortie DateAndTime_ARRAY est trop petite, 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.

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.

ARRAY

Un ARRAY est un tableau d'éléments de même type.

La syntaxe est la suivante : ARRAY [<limites>] OF <Type>

Exemple :

ARRAY [1..2] OF BOOL est un tableau à une dimension composé de deux éléments de type BOOL.

ARRAY [1..10, 1..20] OF INT est un tableau à deux dimensions composé de 10 x 20 éléments de type INT.

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.