TIMESWITCH_ADD İş Bloku

TIMESWITCH_ADD iş bloğu, bir zamanlayıcıda bir etkinlik oluşturur veya değiştirir.

Not: Zamanlayıcı aynı öğede saklanmalıdır.

İpuçları: Bir etkinliği değiştirmek için tüm değerler TIMESWITCH_GET iş bloğu kullanılarak okunabilir.

ADD Girişi

Giriş, pozitif bir kenarda zamanlayıcıda bir etkinlik oluşturur veya değiştirir. Giriş her zaman doğruysa, etkinlik silindiğinde yeniden oluşturulur. Etkinliğin değişikliği algılanmaz.

Önemli: Oluşturma ve aynı anda silme, SSD'yi çok yüklemek nedeniyle önlenmelidir.

TIMESWITCH Girişi

Burada zamanlayıcının veritabanı bir karakter dizisi olarak saklanır. Bu, TIMESWITCH iş bloğu olarak zaten mevcut olmalıdır. Programın sıralamasını da dikkate alarak bu iş bloğun doğru şekilde başlatıldığından emin olun.

ID Girişi

Etkinliğin ID'sini karakter dizisi olarak tanımlar. Bu, benzersiz bir kimlik doğrulaması sağlar ve diğer etkinliklerin bir çatışma oluşturmasını önler. ID sadece harfler ve rakamlardan oluşmalıdır. Büyük/küçük harf duyarlılığı vardır.

Not: ID tüm takvimler için benzersiz olarak tanımlanmalıdır. Bir etkinlik kullanıcı tarafından görselleştirmede başka bir takvime kopyalanabilir.

TITLE Girişi

Etkinliğin başlığını karakter dizisi olarak. Bu satır atlamalar içermemelidir. ADD girişinin doğru olması durumunda, her değişiklik hemen takvime yazılır.

DT_START Girişi

Etkinliğin başlangıç zamanını DT# formatında döndürür. ADD girişinin doğru olması durumunda, her değişiklik hemen takvime yazılır.

İpuçları: Değişim zamanları MKTIME, STR2DT ve EASTER_DATE iş blokları kullanılarak hesaplanabilir.

DT_END Girişi

Etkinliğin bitiş zamanını DT# formatında döndürür. ADD girişinin doğru olması durumunda, her değişiklik hemen takvime yazılır. Bitiş zamanı DT_START'dan küçükse, DT_END başlangıç zamanını tanımlar.

Giriş tanımlanmazsa, DT_START ile aynı değer kabul edilir ve etkinliğin bir impuls oluşturulur.

DIS Girişi

Giriş takviminde etkinliği devre dışı bırakır. ADD girişinin doğru olması durumunda, her değişiklik hemen takvime yazılır.

REPEAT Girişi

Girişte tekrarlar karakter dizisi olarak tanımlanabilir. Bu, REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY ve REPEAT_HOURLY yardımcı işlevleri kullanılarak oluşturulabilir veya açıklama gibi bildirilebilir.

Karakter dizisi iki nokta ile ayrılmış olarak 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ı sonra biter.
• YYYY-MM-DD tarih 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 Tekrarlama

Geçerli hafta gününün sayının içinde olup olmadığı kontrol edilir. Birden fazla gün arka arkaya 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 tekrarlanmaz.

Sayı	Hafta Günü
1	Pazartesi
2	Salı
3	Çarşamba
4	Perşembe
5	Cuma
6	Cumartesi
7	Pazar

Aylık Tekrarlama

Etkinliğin hangi hafta günü tekrar edeceğini tanımlar. -1 ile 4 arasında sayılar desteklenir. 0 veya hiçbir bildirim aynı gün her ay tekrar eder, hafta gününe bağlı olarak değil. Hafta günü ilk tarihden alınır.

Değer	Açıklama
-1	Son hafta günü tekrar eder.
0	Aynı gün tekrar eder. (Varsayılan)
1	İlk hafta günü tekrar eder.
2	İkinci hafta günü tekrar eder.
3	Üçüncü hafta günü tekrar eder.
4	Dördüncü hafta günü tekrar eder.

ERR Çıktısı

Hata durumunda çıkış doğru olarak ayarlanır. Bu, takvimin mevcut olmadığı veya ID'nin tanımlanmadığı veya geçersiz olduğu durumlarda olabilir.