TIMESWITCH_GET İş Bloku
TIMESWITCH_GET İş Bloku, bir zamanlayıcıdan bir etkinliğin tüm bilgilerini döndürür.
Not: Zamanlayıcı aynı öğede saklanmalıdır.
Giriş TIMESWITCH
Burada zamanlayıcının veritabanı karakter dizisi olarak saklanır. Bu, İş Bloku olarak TIMESWITCH olarak zaten mevcut olmalıdır. Programın sıralamasını da dikkate alarak bu iş bloğunun doğru şekilde başlatıldığından emin olun.
Giriş ID
Etkinliğin kimliğini karakter dizisi olarak tanımlar.
Çıkış ERR
Hata durumunda çıkış doğru olarak ayarlanır. Bu, takvimin mevcut olmadığı veya Kimlik tanımsız veya geçersiz tanımlanmış olduğu zaman olabilir.
Çıkış TITLE
Etkinliğin başlığını döndürür.
Çıkış DT_START
Etkinliğin başlangıç zamanı DT# formatında döndürülür.
Çıkış DT_END
Etkinliğin bitiş zamanı DT# formatında döndürülür.
Çıkış DIS
Çıkış doğru ise, etkinlik devre dışı bırakılmıştır ve zaman programından yoksayılır.
Çıkış REPEAT
Çıkış, tekrarları karakter dizisi olarak döndürür. Bu, yardımcı işlevlere REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY ve REPEAT_HOURLY denir.
Karakter dizisi iki nokta ile ayrılabilir veya aşağıdaki şekilde yapılandırılabilir:
w:2:4:135
İlk rakam (küçük harf), tekrarın zaman aralığını tanımlar:
| Kısaltma | Zaman Aralığı |
|---|---|
| h | Saatlik |
| d | Günlük |
| w | Haftalık |
| m | Aylık |
| y | Yıllık |
İkinci rakam, tekrarın aralığını tam sayı olarak tanımlar. En küçük değer 1 dir.
Üçüncü rakam, tekrarın sonunu tanımlar. Burada üç farklı format tanımlanabilir:
- Değer yok: Tekrar sonsuzdur.
- Basit tam sayı olarak: Tekrar, belirtilen tekrar sayısından sonra biter.
- Tarih YYYY-AA-GG olarak: Tekrar, tarihten önce sona erer.
Dördüncü rakam, tekrarın gerçekleştiği hafta günlerini tanımlar. Bu rakam sadece haftalık veya aylık tekrarların tanımlanmasında kullanılır.
Haftalık Tekrarlar
Geçerli hafta gününün sayının içinde olup olmadığı kontrol edilir. Birden fazla gün, birbirinin ardından belirtilebilir. Örneğin 135, Pazartesi, Çarşamba ve Cuma için. Hiçbir değer belirtilmezse (0 veya boş bir karakter dizisi), hiçbir gün tekrar yapmaz.
| Sayı | Hafta Günü |
|---|---|
| 1 | Pazartesi |
| 2 | Salı |
| 3 | Çarşamba |
| 4 | Perşembe |
| 5 | Cuma |
| 6 | Cumartesi |
| 7 | Pazar |
Aylık Tekrarlar
Etkinliğin hangi hafta günü tekrar edeceğini tanımlar. Desteklenen değerler -1 ile 4 arasındadır. 0 veya hiçbir bildirim, her ay aynı gün tekrar eder, hafta gününden bağımsız olarak. Hafta günü ilk tarihden alınır.
| Değer | Açıklama |
|---|---|
| -1 | Son Hafta Günü'nde Tekrar Et. |
| 0 | Aynı Gün Tekrar Et. (Varsayılan) |
| 1 | İlk Hafta Günü'nde Tekrar Et. |
| 2 | İkinci Hafta Günü'nde Tekrar Et. |
| 3 | Üçüncü Hafta Günü'nde Tekrar Et. |
| 4 |
Dördüncü Hafta Günü'nde Tekrar Et. |
Çıkış DT_MODIFY
Çıkış, son değişikliği DT# formatında tanımlar. Bu giriş de tanımsız olabilir, etkinlik sürüm 5.0'dan önce oluşturulmuşsa.