بلوک عملکرد 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 ایجاد شده باشد.