Bloc Fonctionnel TIMESWITCH_ADD

Le bloc fonctionnel TIMESWITCH_ADD crée ou modifie un événement dans une minuterie.

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

Astuce: Pour modifier un événement, toutes les valeurs peuvent être lues à l'aide du bloc fonctionnel TIMESWITCH_GET.

Entrée ADD

L'entrée crée ou modifie un événement dans le calendrier lors d'un front positif. Si l'entrée est toujours vraie, l'événement est recréé dès qu'il a été supprimé. Les modifications d'un événement ne sont pas détectées.

Important: La création et la suppression simultanée doivent être évitées, car cela peut fortement solliciter le SSD.

Entrée TIMESWITCH

Ici, la base de données du minuteur est enregistrée sous forme de chaîne de caractères. Celle-ci doit déjà exister en tant que 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 sous forme de chaîne de caractères de l'événement. Cela permet une identification unique et empêche les autres événements de générer un conflit. L'ID ne doit contenir que des lettres et des chiffres. La casse est prise en compte.

Remarque: L'ID doit être définie de manière unique pour tous les calendriers. Un événement peut être copié par l'utilisateur dans un autre calendrier sur la visualisation.

Entrée TITLE

Le titre de l'événement sous forme de chaîne de caractères. Celui-ci ne doit pas contenir de sauts de ligne. Si l'entrée ADD est vraie, chaque modification est immédiatement écrite dans le calendrier.

Entrée DT_START

L'heure de début de l'événement au format DT#. Si l'entrée ADD est vraie, chaque modification est immédiatement écrite dans le calendrier.

Astuce: Les heures de commutation peuvent être calculées avec les blocs fonctionnels MKTIME, STR2DT et EASTER_DATE.

Entrée DT_END

L'heure de fin de l'événement au format DT#. Si l'entrée ADD est vraie, chaque modification est immédiatement écrite dans le calendrier. Si l'heure de fin est inférieure à DT_START, alors DT_END est défini comme heure de début.

Si l'entrée n'est pas définie, la même valeur que DT_START est supposée et un impuls est généré lors de l'événement.

Entrée DIS

L'entrée désactive l'événement dans le calendrier. Si l'entrée ADD est vraie, chaque modification est immédiatement écrite dans le calendrier.

Entrée REPEAT

Les répétitions peuvent être définies à l'entrée sous forme de chaîne de caractères. Celles-ci peuvent être générées avec les fonctions auxiliaires REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY et REPEAT_HOURLY ou déclarées comme décrit.

La chaîne de caractères peut être construite, séparée par un double-point, 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 qu'entier de la répétition. La plus petite valeur 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 qu'entier simple : La répétition se termine après le nombre défini de répétitions.
• En tant que date YYYY-MM-DD : 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 la définition 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. Comme par exemple 135 pour lundi, mercredi et vendredi. Si aucune valeur n'est indiqué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 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'a pas été définie ou est invalide.