Bllok Funksion TIMESWITCH_ADD

Blloku i funksioneve TIMESWITCH_ADD krijon ose modifikon një ngjarje në një orë të programuar.

Shënim: Ora e programuar duhet të jetë e vendosur në elementin e njëjtë.

Këshillë: Për modifikimin e një ngjarje, të gjitha vlerat mund të lexohen duke përdorur bllokun e funksioneve TIMESWITCH_GET.

Hyrja ADD

Hyrja krijon ose modifikon një ngjarje në kalendar, me një anë positive. Nëse hyrja është gjithmonë e vërtetë, atëherë ngjarja, kur ajo fshihej, do të krijohet përsëri. Ndryshimet e një ngjarje nuk identifikohen.

E rëndësishme: Krijimi dhe fshirja e njëjtë duhet të shmangen, pasi kjo mund të përplasë shumë SSD-në.

Hyrja TIMESWITCH

Këtu bazat e databazës së orës së programuar ruhen si një varg karakteresh. Kjo duhet të ekzistojë tashmë si bllok i funksioneve TIMESWITCH. Ju lutemi, merrni parasysh edhe rendin e programit, që ky bllok i funksioneve të inicializohet korrekt.

Hyrja ID

Përkufizon ID-në si një varg karakteresh të ngjarjes. Kjo lejon identifikimin unik dhe parandalon që ngjarjet e tjera të krijojnë konflikt. ID-së duhet të përbëhet vetëm nga shkronja dhe numrat. Përjashtimi i madh dhe i vogël merret parasysh.

Shënim: ID-së duhet të jetë e përcaktuar në mënyrë unike për të gjithë kalendarët. Një ngjarje mund të kopjohet nga përdoruesi në vizualizim në një kalendar tjetër.

Hyrja TITLE

Titulli i ngjarjes si varg karakteresh. Ky nuk duhet të përmbajë kthime në rresht. Nëse hyrja ADD është e vërtetë, çdo ndryshim shkruhet menjëherë në kalendar.

Hyrja DT_START

Momenti i fillimit të ngjarjes në format DT#. Nëse hyrja ADD është e vërtetë, çdo ndryshim shkruhet menjëherë në kalendar.

Këshillë: Kohët e programimit mund të llogariten me blloqet e funksioneve MKTIME, STR2DT dhe EASTER_DATE.

Hyrja DT_END

Momenti i përfundimit të ngjarjes në format DT#. Nëse hyrja ADD është e vërtetë, çdo ndryshim shkruhet menjëherë në kalendar. Nëse momenti i përfundimit është më i vogël se DT_START, atëherë DT_END përcaktohet si momenti i fillimit.

Nëse hyrja nuk përcaktohet, atëherë vlera e njëjtë si DT_START merret dhe një impuls krijohet në ngjarje.

Hyrja DIS

Hyrja çaktivizon ngjarjen në kalendar. Nëse hyrja ADD është e vërtetë, çdo ndryshim shkruhet menjëherë në kalendar.

Hyrja REPEAT

Në hyrje mund të përcaktohen ripërsërimet si një varg karakteresh. Këto mund të gjenerohen me funksionet ndihmëse REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY dhe REPEAT_HOURLY ose të deklarohen siç është përshkruar.

Vargu karakteresh mund të ndahet me dy pika si më poshtë:

w:2:4:135

Numri i parë (i vogël) përcakton intervalin e ripërsëritjes:

Shkurtesa	Intervali i kohës
h	Çdo Orë
d	Çdo Ditë
w	Çdo Javë
m	Çdo Muaj
y	Çdo Vit

Numri i dytë përcakton intervalin si një numër i plotë i ripërsëritjes. Vlera më e vogël është 1.

Numri i tretë përcakton fundin e ripërsëritjes. Këtu mund të përcaktohen tre formate të ndryshme:

• Asnjë vlerë: Ripërsëritja është e pavdekshme.
• Si një numër i thjeshtë i plotë: Ripërsëritja mbaron pas numrit të përcaktuar të ripërsëritjeve.
• Si datë YYYY-MM-DD: Ripërsëritja ndalet para datës.

Numri i katërt përcakton ditët e javës në të cilat ripërsëritja ndodh. Ky numër përdoret vetëm kur përcaktohen ripërsëritje javore ose mujore.

Ripërsëritje Javore

Kontrollohet nëse dita e tanishme e javës është e pranishme në numër. Dita të shumta mund të caktohen thjesht njëra pas tjetrës. Si për shembull 135 për E Diel, E Hënë dhe E Premte. Nëse nuk caktohet asnjë vlerë (0 ose një varg karakteresh bosh), atëherë ripërsëritja ndodh në ditën e javës.

Numri	Dita e Javës
1	E Hënë
2	E Martë
3	E Mërkurë
4	E Enjte
5	E Premte
6	E Shtunë
7	E Diel

Ripërsëritje Muajore

Përkufizon në cilën ditë të javës duhet të ripërsëritohet ngjarja. Mbështeten numra nga -1 deri në 4. 0 ose asnjë deklaratë ripërsëriton çdo muaj në ditën e njëjtë, pavarësisht nga dita e javës. Dita e javës merr vlerën nga data e parë.

Vlera	Përshkrim
-1	Ripërsëritet në ditën e fundit të javës.
0	Ripërsëritet në ditën e njëjtë. (Standard)
1	Ripërsëritet në ditën e parë të javës.
2	Ripërsëritet në ditën e dytë të javës.
3	Ripërsëritet në ditën e tretë të javës.
4	Ripërsëritet në ditën e katërt të javës.

Dalja ERR

Në rast gabimi, dalja vendoset në vërtetë. Kjo mund të jetë nëse kalendari nuk ekziston ose ID-së nuk është përcaktuar ose është e pavlefshme.