फंक्शन ब्लॉक TIMESWITCH_GET

फंक्शन ब्लॉक TIMESWITCH_GET एक टाइम स्विच के किसी घटना के सभी जानकारी को वापस करता है।

हिंट: टाइम स्विच उसी एलिमेंट में होना चाहिए।

इनपुट TIMESWITCH

यहाँ टाइमर के डेटाबेस को एक स्ट्रिंग के रूप में रखा जाता है। यह फंक्शन ब्लॉक TIMESWITCH के रूप में पहले से ही मौजूद होना चाहिए। कार्यक्रम की क्रमिकता पर भी ध्यान दें, ताकि यह फंक्शन ब्लॉक सही ढंग से प्रारंभ हो सके।

इनपुट ID

घटना के आईडी को एक स्ट्रिंग के रूप में परिभाषित करता है।

आउटपुट ERR

त्रुटि की स्थिति में, आउटपुट को सत्य मान दिया जाता है। यह तब हो सकता है जब कैलेंडर मौजूद नहीं हो या आईडी गलत या अमान्य रूप से परिभाषित किया गया हो।

आउटपुट TITLE

घटना के शीर्षक को वापस करता है।

आउटपुट DT_START

घटना की प्रारंभिक समय सीमा को DT# फॉर्मेट में वापस करता है।

आउटपुट DT_END

घटना की समाप्ति समय सीमा को DT# फॉर्मेट में वापस करता है।

आउटपुट DIS

अगर आउटपुट सत्य है, तो घटना निष्क्रिय है और टाइम प्रोग्राम द्वारा अनदेखा किया जाता है।

आउटपुट REPEAT

आउटपुट रिपीट को एक स्ट्रिंग के रूप में वापस करता है। ये REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY और REPEAT_HOURLY सहायक फंक्शन के अनुसार होते हैं।

स्ट्रिंग को एक डबल पॉइंट से अलग किया जा सकता है या निम्नलिखित प्रकार से बनाया जा सकता है:

w:2:4:135

पहला अंक (छोटा अक्षर) रिपीट के समय अंतराल को परिभाषित करता है:

शॉर्टकट	समय अंतराल
h	प्रत्येक घंटे
d	प्रत्येक दिन
w	प्रत्येक सप्ताह
m	प्रत्येक महीने
y	प्रत्येक वर्ष

दूसरा अंक रिपीट के अंतराल को एक पूर्णांक के रूप में परिभाषित करता है। सबसे छोटा मान 1 है।

तीसरा अंक रिपीट की समाप्ति को परिभाषित करता है। यहाँ तीन अलग-अलग फॉर्मेट परिभाषित किए जा सकते हैं:

• कोई मान नहीं: रिपीट अनंत है।
• एक साधारण पूर्णांक के रूप में: रिपीट परिभाषित की गई संख्या के बाद समाप्त हो जाती है।
• तिथि YYYY-MM-DD के रूप में: रिपीट तिथि से पहले समाप्त हो जाता है।

चौथा अंक उन सप्ताह के दिनों को परिभाषित करता है जब रिपीट होता है। इस अंक का उपयोग केवल सप्ताहिक या मासिक रिपीट को परिभाषित करने में किया जाता है।

सप्ताहिक रिपीट

यह जांचता है कि वर्तमान सप्ताह का दिन संख्या में मौजूद है या नहीं। कई दिनों को आसानी से एक के बाद दूसरे के रूप में दिया जा सकता है। जैसे कि 135 सोमवार, मंगलवार और शुक्रवार के लिए। अगर कोई मान नहीं दिया जाता (0 या एक खाली स्ट्रिंग), तो किसी दिन रिपीट नहीं होता है।

संख्या	सप्ताह का दिन
1	सोमवार
2	मंगलवार
3	बुधवार
4	गुरुवार
5	शुक्रवार
6	शनिवार
7	रविवार

मासिक रिपीट

परिभाषित करता है कि घटना किस सप्ताह के दिन दोहराई जानी चाहिए। संख्याओं का समर्थन किया जाता है -1 से 4 तक। 0 या कोई घोषणा नहीं हर महीने उसी दिन दोहराई जाती है, सप्ताह के दिन से स्वतंत्र। सप्ताह का दिन पहले तिथि से लिया जाता है।

मान	विवरण
-1	अंतिम सप्ताह के दिन दोहराता है।
0	उसी दिन दोहराता है। (डिफ़ॉल्ट)
1	पहले सप्ताह के दिन दोहराता है।
2	दूसरे सप्ताह के दिन दोहराता है।
3	तीसरे सप्ताह के दिन दोहराता है।
4	चौथे सप्ताह के दिन दोहराता है।

आउटपुट DT_MODIFY

आउटपुट DT# फॉर्मेट में अंतिम परिवर्तन को परिभाषित करता है। यह इनपुट अनपरिभाषित भी हो सकता है, अगर घटना वर्जन 5.0 से पहले बनाई गई थी।