Bloc Fonctionnel TIMESWITCH_GET

Le bloc fonctionnel TIMESWITCH_GET renvoie toutes les informations d'un événement d'une minuterie.

Remarque : La minuterie doit être enregistrée dans le même élément.

Entrée TIMESWITCH

Ici, la base de données de l'horloge est enregistrée en tant que chaîne de caractères. Celle-ci doit déjà exister sous forme de bloc fonctionnel TIMESWITCH. Veuillez également tenir compte de l'ordre du programme pour que ce bloc fonctionnel soit correctement initialisé.

Entrée ID

Définir l'ID en tant que chaîne de caractères de l'événement.

Sortie ERR

En cas d'erreur, la sortie est définie sur vrai. Cela peut se produire si le calendrier n'existe pas ou si l'ID n'est pas définie ou est invalide.

Sortie TITLE

Renvoie le titre de l'événement.

Sortie DT_START

Le moment de début de l'événement au format DT#.

Sortie DT_END

Le moment de fin de l'événement au format DT#.

Sortie DIS

Si la sortie est vraie, l'événement est désactivé et ignoré par le programme horaire.

Sortie REPEAT

La sortie renvoie les répétitions sous forme de chaîne de caractères. Celles-ci correspondent aux fonctions auxiliaires REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY et REPEAT_HOURLY.

La chaîne de caractères peut être séparée par un double-point ou construite comme suit :

w:2:4:135

Le premier chiffre (en minuscule) définit l'intervalle de répétition :

Abréviation	Intervalle
h	Hebdomadaire
d	Quotidien
w	Hebdomadaire
m	Mensuel
y	Annuel

Le deuxième chiffre définit l'intervalle en tant que nombre entier de répétition. La valeur la plus petite est 1.

Le troisième chiffre définit la fin de la répétition. Ici, trois formats différents peuvent être définis :

• Aucune valeur : La répétition est infinie.
• En tant que nombre entier simple : La répétition se termine après le nombre défini de répétitions.
• En tant que date AAAA-MM-JJ : La répétition est terminée avant la date.

Le quatrième chiffre définit les jours de la semaine auxquels la répétition a lieu. Ce chiffre n'est utilisé que pour définir des répétitions hebdomadaires ou mensuelles.

Répétitions Hebdomadaires

Il est vérifié si le jour de la semaine actuel est présent dans le nombre. Plusieurs jours peuvent être simplement indiqués les uns à la suite des autres. Par exemple, 135 pour lundi, mercredi et vendredi. Si aucune valeur n'est spécifiée (0 ou une chaîne de caractères vide), alors la répétition n'a lieu aucun jour.

Nombre	Jour De La Semaine
1	Lundi
2	Mardi
3	Mercredi
4	Jeudi
5	Vendredi
6	Samedi
7	Dimanche

Répétitions Mensuelles

Définir le jour de la semaine auquel l'événement doit être répété. Les nombres de -1 à 4 sont pris en charge. 0 ou aucune déclaration répète chaque mois au même jour, indépendamment du jour de la semaine. Le jour de la semaine est repris à partir de la première date.

Valeur	Description
-1	Répète le dernier jour de la semaine.
0	Répète au même jour. (Par défaut)
1	Répète le premier jour de la semaine.
2	Répète le deuxième jour de la semaine.
3	Répète le troisième jour de la semaine.
4	Répète le quatrième jour de la semaine.

Sortie DT_MODIFY

La sortie définit la dernière modification au format DT#. Cette entrée peut également être indéfinie si l'événement a été créé avant la version 5.0.