Funktionsblock TIMESWITCH_ADD

Funktionsblocket TIMESWITCH_ADD skapar eller modifierar ett händelse i en tidsur.

Anmärkning: Tidsuren måste vara lagrad i samma element.

Tips: För att ändra ett händelse kan alla värden läsas med hjälp av funktionsblocket TIMESWITCH_GET.

Ingång ADD

Ingången skapar eller modifierar en händelse i kalendern vid en positiv flank. Om ingången alltid är sann, så skapas händelsen igen när den har raderats. Ändringar av ett händelse identifieras inte.

Viktigt: Skapande och samtidigt radering bör undvikas eftersom detta kan belasta SSD:n mycket.

Ingång TIMESWITCH

Här lagras tidsurens databas som en sträng. Den måste redan existera som funktionsblocket TIMESWITCH. Observera även programsekvensen så att detta funktionsblock initieras korrekt.

Ingång ID

Definierar händelsens ID som en sträng. Detta möjliggör en unik identifiering och förhindrar att andra händelser skapar konflikt. ID:n bör endast bestå av bokstäver och siffror. Stor- och små bokstäver beaktas.

Anmärkning: ID:n bör vara unikt definierad för alla kalendrar. Ett händelse kan kopieras av användaren på visualiseringen till en annan kalender.

Ingång TITLE

Händelsens titel som sträng. Denna bör inte innehålla radbrytningar. Om ingången ADD är sann, skrivs varje ändring omedelbart till kalendern.

Ingång DT_START

Händelsens starttidpunkt i formatet DT#. Om ingången ADD är sann, skrivs varje ändring omedelbart till kalendern.

Tips: Tidsinställningarna kan beräknas med funktionsblocken MKTIME, STR2DT och EASTER_DATE.

Ingång DT_END

Händelsens sluttidpunkt i formatet DT#. Om ingången ADD är sann, skrivs varje ändring omedelbart till kalendern. Om sluttidpunkten är mindre än DT_START, definieras DT_END som starttidpunkt.

Om ingången inte definieras, antas samma värde som DT_START och ett puls skapas vid händelsen.

Ingång DIS

Ingången inaktiverar händelsen i kalendern. Om ingången ADD är sann, skrivs varje ändring omedelbart till kalendern.

Ingång REPEAT

På ingången kan upprepningarna definieras som en sträng. Dessa kan genereras med hjälpfunktionerna REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY och REPEAT_HOURLY eller deklareras som beskrivet.

Strängen kan vara uppbyggd med dubbelpunktsseparering enligt följande:

w:2:4:135

Den första siffran (liten bokstav) definierar tidsintervallet för upprepningen:

Förkortning	Tidsintervall
h	Varje timme
d	Varje dag
w	Varje vecka
m	Varje månad
y	Varje år

Den andra siffran definierar intervallet som heltal för upprepningen. Minsta värdet är 1.

Den tredje siffran definierar slutet på upprepningen. Här kan tre olika format definieras:

• Ingen värde: Upprepningen är oändlig.
• Som en enkel heltal: Upprepningen slutar efter det definierade antalet upprepningar.
• Som datum YYYY-MM-DD: Upprepningen avslutas innan datumet.

Den fjärde siffran definierar veckodagarna då upprepningen sker. Denna siffra används endast vid definition av veckovisa eller månadsvisa upprepningar.

Veckovisa Upprepningar

Det kontrolleras om den aktuella veckodagen finns i talet. Flera dagar kan anges enkelt efter varandra. Till exempel 135 för måndag, onsdag och fredag. Om inget värde anges (0 eller en tom sträng), upprepas det inte på någon dag.

Tal	Veckodag
1	Måndag
2	Tisdag
3	Onsdag
4	Torsdag
5	Fredag
6	Lördag
7	Söndag

Månadsvisa Upprepningar

Definierar vilken veckodag händelsen ska upprepas. Stöds är värden från -1 till 4. 0 eller ingen deklaration upprepas varje månad på samma dag, oberoende av veckodag. Veckodagen hämtas från det första datumet.

Värde	Beskrivning
-1	Upprepas på sista veckodagen.
0	Upprepas på samma dag. (Standard)
1	Upprepas på första veckodagen.
2	Upprepas på andra veckodagen.
3	Upprepas på tredje veckodagen.
4	Upprepas på fjärde veckodagen.

Utgång ERR

Vid felaktig situation sätts utgången till sann. Detta kan vara om kalendern inte existerar eller ID:n inte är definierad eller ogiltig.