Bllok Funksion TIMESWITCH_GET

Blloku i funksioneve TIMESWITCH_GET kthen te gjitha informacionet e nje ngjarje te nje orari me kohe.

Shenim: Orari duhet te vendoset ne elementin e njejte.

Hyrja TIMESWITCH

Ketu vendoset baza e te dhenave e orarit si nje string. Kjo duhet te ekzistoj si bllok funksion TIMESWITCH. Ju lutemi pergjigjeni rendin e programit, qe ky bllok i funksioneve te inicializohet korrekt.

Hyrja ID

Definoi ID-në si një string të ngjarjes.

Dalja ERR

Në rast gabimi, dalja vendoset në vërtetë. Kjo mund të jetë nëse kalendari nuk ekziston ose ID nuk është i definuar ose i pavlefshëm.

Dalja TITLE

Kthen titullin e ngjarjes.

Dalja DT_START

Pika fillestare e ngjarjes në format DT# kthehet.

Dalja DT_END

Pika përfundimtare e ngjarjes në format DT# kthehet.

Dalja DIS

Nëse dalja është e vërtetë, atëherë ngjarja është çaktivizuar dhe ignorohet nga programi i kohës.

Dalja REPEAT

Dalja kthen përsëritjet si një string. Këto përputhen me funksionet ndihmëse REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY dhe REPEAT_HOURLY.

Stringu mund të ndahet nga një dy pikëpresje ose mund të ndërtuar si më poshtë:

w:2:4:135

Numri i parë (me shkronja të vogla) definon intervalin e pë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ë definon intervalin si një numër i plotë i përsëritjes. Vlera më e vogël është 1.

Numri i tretë definon fundin e përsëritjes. Këtu mund të caktohen tre formate të ndryshme:

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

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

Pë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ë string bosh), atëherë nuk bëhet përsëritje 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

Përsëritje Muajore

Definoi në cilën ditë të javës duhet të përsëritohet ngjarja. Numrat nga -1 deri në 4 mbështeten. 0 ose asnjë deklarim përsërit çdo muaj në ditën e njëjtë, pavarësisht nga dita e javës. Dita e javës merret nga data e parë.

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

Dalja DT_MODIFY

Dalja definon ndryshimin e fundit në format DT#. Ky hyrje mund të jetë edhe pa përcaktuar, nëse ngjarja u krijua para versionit 5.0.